プロパティ | 説明 |
|---|---|
maxTaskUnits | Secure Agentが実行されているオンプレミスマシンで同時に実行できるアプリケーション取り込みとレプリケーションタスクユニットとデータベース取り込みとレプリケーションタスクユニットの最大数。 タスクユニットは、ハードウェアまたはソフトウェアの容量や可用性とは関係がありません。maxTaskUnitsを設定すると、CPU使用率を正確に制御できます。有効な値は1-2000000000（20億）です。 Secure Agentマシンの適切なタスクユニット数を計算するには、コア数を3または4で割ることをお勧めします。例えば、8コアのマシンを使用している場合は、このプロパティを2に設定できます。その後、CPU使用率を監視し、必要に応じてプロパティ値を調整してパフォーマンスチューニングを行います。 初期ロード処理中、このプロパティは同時にアンロードできるテーブルの数を決定します。残りのテーブルはキューに入れられ、リソースが使用可能になるとアンロード処理を開始します。 注: 1つのジョブで多くのテーブルを処理できます。処理できるテーブルの総数の制限となるのは、使用可能なメモリのみです。1KBの行サイズに基づく初期ロードタスクには、平均してテーブルごとに25MBのRAMが必要です。 増分ロード処理中、このプロパティは同時に実行できるアプリケーション取り込みとレプリケーションジョブとデータベース取り込みとレプリケーションジョブの数を決定します。 このプロパティをSecure Agentマシンのコア数よりも大きい値に設定すると、タスク実行の並列処理が増える可能性がありますが、タスク実行時にパフォーマンスのボトルネックが発生する可能性もあります。 |
serviceLogRetentionPeriod | 最終更新がファイルに書き込まれた後に、各内部データベース取り込みサービスログファイルが保持される日数。この保持期間が経過すると、ログファイルは削除されます。デフォルト値は7日です。 サービスログは、それらが作成されたSecure Agentホスト（<infaagent>/apps/Database_Ingestion/logs）に保持されます。 注: このプロパティは、アプリケーション取り込みとレプリケーションとデータベース取り込みとレプリケーションの両方に適用されます。 |
taskLogRetentionPeriod | 最終更新がジョブログファイルに書き込まれた後、各ジョブログファイルを保存する日数。この保持期間が経過すると、ログファイルは削除されます。デフォルト値は7日です。 |
ociPath | Oracleソースおよびターゲットの場合、oci.dllまたはlibcIntsh.soファイルが含まれるOracle Call Interface（OCI）ディレクトリへのパス。デフォルトでは、Oracleは、$ORACLE_HOME/lib（Linuxの場合）または%ORACLE_HOME%\bin（Windowsの場合）を使用します。OCIライブラリは、データベース取り込みCDCタスクによってOracleに接続するために使用されます。 実行中のDBMIエージェントの場合、この値はWindowsのPATH環境変数の値、またはLinuxのLD_LIBRARY_PATH環境変数の値に付加されます。PATHまたはLD_LIBRARY_PATH環境変数にすでにOCIパスが含まれている場合、このプロパティは必要ありません。 注: このプロパティはデータベース取り込みとレプリケーションにのみ適用されます。 |
serviceUrl | データベース取り込みサービスがInformatica Intelligent Cloud Servicesクラウドへの接続に使用するURL。 注: このプロパティは、アプリケーション取り込みとレプリケーションとデータベース取り込みとレプリケーションの両方に適用されます。 |
logLevel | データベース取り込みサービスが生成するログに含める詳細レベル。次のオプションがあります。
デフォルト値はトレースです。 注: このプロパティは、アプリケーション取り込みとレプリケーションとデータベース取り込みとレプリケーションの両方に適用されます。 |
taskExecutionHeapSize | タスク実行サービスの最大ヒープサイズ（ギガバイト単位）。このプロパティには、実行されるすべてのアプリケーション取り込みとレプリケーション、およびデータベース取り込みとレプリケーションのタスクをホストする単一のJavaプロセスに渡される値が含まれます。多数のタスクを実行している場合や大量のデータを処理している場合、taskExecutionHeapSizeを増やすことが必要になることがあります。このプロパティ値の後に、ギガバイトの場合は「g」と入力します（例: 「9g」）。デフォルト値は「8g」です。 注: このプロパティは、アプリケーション取り込みとレプリケーションとデータベース取り込みとレプリケーションの両方に適用されます。 |
useProxy | このプロパティをtrueに設定すると、ターゲットへの接続時およびターゲットへのデータの書き込み時にDBMIエージェントがプロキシを通過できるようになります。次に、DBMIエージェントは、Secure Agentプロキシ構成のプロキシ設定を使用します。デフォルトでは、プロキシ設定は使用されません。 注: このプロパティは、アプリケーション取り込みとレプリケーションとデータベース取り込みとレプリケーションの両方に適用されます。 |
intermediateStorageDirectory | 増分ロードジョブおよび初期ロードと増分ロードの組み合わせジョブの場合、関連するタスク定義で［永続ストレージの有効化］オプションが選択されているときに、データを含む中間ファイルが保存されるローカルルートディレクトリです。 注: このプロパティはデータベース取り込みとレプリケーションにのみ適用されます。 |
storageBackupDirectory | 増分ロードジョブおよび初期ロードと増分ロードの組み合わせジョブの場合、関連するタスク定義で［永続ストレージの有効化］オプションが選択されているときに、バックアップファイルが保存されるディレクトリへのパスです。 注: このプロパティはデータベース取り込みとレプリケーションにのみ適用されます。 |
storageProperties | 増分ロードジョブおよび初期ロードと増分ロードの組み合わせジョブの場合、関連するタスク定義で［永続ストレージの有効化］オプションが選択されているときに使用されるキー=値のペアのカンマ区切りリストです。このプロパティを指定する場合は、Informaticaグローバルカスタマサポートにお問い合わせください。 注: このプロパティはデータベース取り込みとレプリケーションにのみ適用されます。 |
supportedLoadTypes | アプリケーション取り込みとレプリケーションジョブ、およびデータベース取り込みとレプリケーションジョブの場合に、データベース取り込みエージェントサービスが処理できる負荷のタイプ。次の値を1つ以上、カンマ（,）で区切って入力することができます。
デフォルトはINITIAL,INCREMENTAL,INCREMENTAL_STAGINGで、これはすべてのロードタイプを示します。 注: 複数のデータベース取り込みエージェントが同じロードタイプをサポートするように設定されている場合、ジョブは使用可能なタスクユニットが最も多いエージェントを使用します。 |
環境変数 | 説明 |
|---|---|
DBMI_REPLACE_UNSUPPORTED_CHARS | Microsoft Azure Synapse Analyticsターゲットの場合に、アプリケーション取り込みとレプリケーションジョブまたはデータベース取り込みとレプリケーションジョブが、ターゲットが正しく処理できない文字データ内の文字を置き換えるかどうかを指定します。文字の置き換えを有効にするには、この環境変数をtrueに設定します。 DBMI_REPLACE_UNSUPPORTED_CHARS=true 設定後、アプリケーション取り込みとレプリケーションまたはデータベース取り込みとレプリケーションは、DBMI_UNSUPPORTED_CHARS_REPLACEMENT環境変数に指定されている文字を使用して、サポートされていない文字を置き換えます。 |
DBMI_UNSUPPORTED_CHARS_REPLACEMENT | DBMI_REPLACE_UNSUPPORTED_CHARS環境変数がtrueに設定されている場合に、Microsoft Azure Synapse Analyticsターゲットが正しく処理できないソースデータ内の文字を置き換える文字を指定します。 デフォルト値: ? （疑問符） 注: この環境変数はデータベース取り込みとレプリケーションに対してのみ定義します。 |
DBMI_WRITER_CONN_POOL_SIZE | アプリケーション取り込みとレプリケーションジョブまたはデータベース取り込みとレプリケーションジョブが変更データをターゲットにプロパゲートするために使用する接続の数を示します。デフォルト値は8です。有効な値は4～8です。 |
DBMI_WRITER_RETRIES_MAX_COUNT | データベース取り込みとレプリケーションジョブがソースデータをAmazon S3またはMicrosoft Azure Data Lake Storage Gen2ターゲットにロードしている最中にネットワークの問題が発生した場合に、ジョブで初期ロードまたは増分ロードを続行する要求を再試行する最大回数を指定します。再試行がすべて失敗した場合、ジョブは失敗となります。 デフォルト値は5です。 |
DBMI_WRITER_RETRIES_INTERVAL_IN_MILLIS | ネットワークで問題が発生した場合に、データベース取り込みとレプリケーションジョブがAmazon S3またはMicrosoft Azure Data Lake Storage Gen2ターゲットへの初期ロードまたは増分ロードを続行する要求を再試行する前に待機する間隔（ミリ秒単位）を指定します。 デフォルト値は1000です。 |
プロパティ | 説明 |
|---|---|
taskExecutionHeapSize | メモリ割り当てプールの最大ヒープサイズ（ギガバイト単位）。このプロパティには、実行するタスクをホストする1つのJavaプロセスに渡される値が含まれます。この値に続けてギガバイトの場合は「g」と入力します（例: 「3g」）。デフォルト値は「2g」です。 |
taskStartTimeoutSeconds | タスクの起動がタイムアウトするまでの期間（秒単位）。この時間が経過すると、エラーが発生します。デフォルト値は120です。 |
タイプ | 名前 | 説明 |
|---|---|---|
AGENT_RUNTIME_SETTINGS | file-listener-snapshot-dir | 新しいファイルリスナコンポーネントのスナップショットが追加されるディレクトリ。次のディレクトリパスを追加できます。
<Secure agent installation directory>/apps/MassIngestionRuntime/data/monitor Secure agent installation directoryにはSecure Agentがインストールされているディレクトリの名前が入ります。 注: グループに複数のSecure Agentが存在する場合は、すべてのエージェントで共有されるスナップショットディレクトリを使用します。 |
AGENT_RUNTIME_SETTINGS | mi-task-workspace-dir | ファイル取り込みとレプリケーションタスクがファイルをターゲットに転送するときに中間ステージング領域として使用するエージェント内のディレクトリです。エージェント内のカスタムの場所のディレクトリ。このパスは、共有場所、マウントされた場所、およびエージェント内のデフォルトの場所とは異なる場所にすることができます。 |
AGENT_RUNTIME_SETTINGS | mi-task-project-dir | ファイル取り込みとレプリケーションタスクがプロジェクトファイルを保存するディレクトリ。エージェント内のカスタムの場所のディレクトリ。このパスは、共有場所、マウントされた場所、およびエージェント内のデフォルトの場所とは異なる場所にすることができます。 |
AGENT_RUNTIME_SETTINGS | mi-task-logs-dir | ファイル取り込みとレプリケーションタスクがタスクログファイルを保存するディレクトリ。エージェント内のカスタムの場所のディレクトリ。このパスは、共有場所、マウントされた場所、およびエージェント内のデフォルトの場所とは異なる場所にすることができます。 |
AGENT_RUNTIME_SETTINGS | mi-task-quarantine-dir | ウイルススキャンの実行時に検出された感染ファイルをファイル取り込みとレプリケーションタスクが保存するディレクトリ。エージェント内のカスタムの場所のディレクトリ。このパスは、共有場所、マウントされた場所、およびエージェント内のデフォルトの場所とは異なる場所にすることができます。 例: userdata\quarantine 注: 検疫ディレクトリを自動的にクリーンアップするには、検疫場所のエージェントプロパティを/tmp/informatica/fmi/quarantineのようなシステム一時ファイルの場所に設定します。 |
AGENT_RUNTIME_SETTINGS | agent-dedup-repository | スキップされた重複ファイルに関する情報は、Informatica Intelligent Cloud Services（IICS）に保存されます。スキップされた重複ファイルの情報をSecure Agentに保存するには、プロパティをtrueに設定します。 デフォルトはfalseです。 スキップされた重複に関する情報の保存については、「ファイル取り込みとレプリケーションガイド」を参照してください。 |
AGENT_RUNTIME_SETTINGS | mi-dedup-snapshot-dir | スキップされた重複ファイルに関する情報をSecure Agentに保存するためのパスを入力します。 agent-dedup-repositoryプロパティがtrueに設定されている場合のみ適用されます。 |
AGENT_RUNTIME_SETTINGS | file-listener-max-pool-size | ファイルリスナを実行するスレッドの最大数。 デフォルトは20です。 |
AGENT_RUNTIME_SETTINGS | file-listener-core-pool-size | スレッドの合計数。 デフォルトは20です。 |
AGENT_RUNTIME_SETTINGS | fmi-task-max-pool-size | ファイル取り込みとレプリケーションタスクを実行するスレッドの最大数。 デフォルトは50です。 |
AGENT_RUNTIME_SETTINGS | fmi-task-core-pool-size | スレッドの初期数または最小数。 デフォルトは20です。 |
AGENT_RUNTIME_SETTINGS | ftp-receive-socket-buffer-size | FTPインバウンドパケットのバッファサイズ。 デフォルトは16バイトです。 |
AGENT_RUNTIME_SETTINGS | ftp-send-socket-buffer-size | FTPアウトバウンドパケットのバッファサイズ。 デフォルトは16バイトです。 |
AGENT_RUNTIME_SETTINGS | http-client-timeout | Informatica Intelligent Cloud Servicesへのエージェントの要求のタイムアウト時間（秒単位）。 デフォルトは30秒です。 |
PGP_SETTINGS | public-keyring-path | パブリックキーリングを保存するディレクトリ。次のディレクトリパスを追加できます。
../data/pubring.pkr pubring.pkrにはパブリックキーリングを保存するファイルの名前が入ります。 <Secure agent installation directory>/apps/MassIngestionRuntime/data/pubring.pkr pubring.pkrにはパブリックキーリングを保存するファイルの名前が、Secure agent installation directoryにはエージェントがインストールされているディレクトリの名前が入ります。 |
PGP_SETTINGS | secret-keyring-path | シークレットキーリングを保存するディレクトリ。次のディレクトリパスを追加できます。
../data/secring.pkr secring.pkrにはシークレットキーリングを保存するファイルの名前が入ります。 <Secure agent installation directory>/apps/MassIngestionRuntime/data/secring.pkr secring.pkrにはシークレットキーリングを保存するファイルの名前が、Secure Agent installation directoryにはエージェントがインストールされているディレクトリの名前が入ります。 |
JVM_SETTINGS | app-heap-size | ファイル取り込みとレプリケーションアプリケーションの最小および最大ヒープサイズ。 デフォルトは-Xms256m -Xmx2048mです。 |
JVM_SETTINGS | lcm-heap-size | ライフサイクル管理スクリプトの最小および最大ヒープサイズ。 デフォルトは-Xms32m -Xmx128mです。 |
タイプ | 名前 | 説明 |
|---|---|---|
AGENT_RUNTIME_SETTINGS | ComplexFileDisableWriteChecksum | crcファイルを無視するには、値をTrueに設定します。ジョブは、Hadoop Files V2をソースとし、Snowflake Cloud Data Warehouse V2をターゲットとして正常に実行されます。 |
ソース | フォルダパス |
|---|---|
Windows | <フォルダパス> 例: C:\temp |
Linux | /<フォルダパス>/ 例: /root/path |
Windowsの共有の場所 | <フォルダパス>にスラッシュ（\）を追加 例えば、パス\\INV12B2B01\Shared\pathは、\\\\INV12B2B01\\Shared\\pathと指定されます |
タイプ | プロパティ名 | 説明 |
|---|---|---|
エンジン | MaxLogFileSize | エンジンが作成可能なログファイルの最大サイズ。 デフォルトは5 MBです。 |
エンジン | LogLevel | エンジンのログレベル。 |
エージェント | DataflowPullInterval | エージェントがタスクで更新を確認するまでの間隔。 デフォルトは60秒です。 |
エージェント | JVM | エージェントのJVMプロパティのリスト。例：[-Xms256M -Xmx256M] |
エージェント | LogLevel | エージェントのログレベル。 |
エージェント | MaxLogFileSize | エージェントが作成可能なログファイルの最大サイズ。 デフォルトは10MBです。 |
エージェント | MaxNumberOfBackups | エージェントのバックアップログファイルの最大数。 デフォルトは5です。 |
スクリプト | LogLevel | スクリプトのログレベル。 |
スクリプト | MaxFileSize | 最大ファイルサイズ。この最大ファイルサイズに達した後、ログはロールオーバーされ、新しいファイルが作成されます。 デフォルトは10MBです。 |
スクリプト | MaxBackupIndex | ロールオーバー後に保持するバックアップファイルの最大数。 デフォルトは5です。 |
コマンド | 説明 | 例 |
|---|---|---|
app-config | ストリーミングエージェントアプリケーションの現在の構成を表示します。 | infa/stream :>app-config deploy.pull.interval : 60 health.poll.interval : 30 minifi.ingester.file.location : ./conf siagent.communication.mode : Online siagent.monitoring.persist.dir : ../data siagent.statistics.post.batchsize : 720 siagent.statistics.post.concurrency : 60 siagent.status.persist.dir : ../data statistics.poll.interval : 30 |
app-setconfig | このコマンドを使用して、次のプロパティを設定します。
--keyと--valueトークンはオプションです。 | infa/stream :>app-setconfig --key siagent.statistics.post.batchsize --value 20 または infa/stream :>app-setconfig siagent.statistics.post.batchsize 20 |
app-status | ストリーミングエージェントの現在のステータスを表示します。 health status codeとhealth error messageはAdministratorに表示されるエージェント（サービス）のステータスを示します。 uptimeはストリーミングエージェントアプリケーションが使用可能になってからの秒数を示します。 | infa/stream :>app-status health error message : No errors health status code : RUNNING(0) uptime : 67828 |
app-statistics | ストリーミングエージェントの全体的な統計収集のメタデータとステータスを表示します。
| infa/stream :>app-statistics collection interval : 30 last batch size : 2 last time collected : 7/3/20 10:19:03 AM IST last time posted : 7/3/20 10:18:53 AM IST max batch size : 20 pending snapshots : 3 post interval : 30 |
clear | 画面をクリアします。 | - |
exit、quit | アプリケーションを終了します。 | - |
help | 使用可能なすべてのコマンドのサマリを表示します。 | infa/stream :>help AVAILABLE COMMANDSAgent Application Commands app-config: Show agent application configuration app-setmode: Set the communication mode [Online/Offline] app-status: Show agent application statusBuilt-In Commands clear: Clear the shell screen. exit, quit: Exit the shell. help: Display help about available commands.Streaming Ingestion Task Commands task-health: Show streaming ingestion task health task-list: Show streaming ingestion task list task-metadata: Show streaming ingestion task metadata |
task-list | ストリーミングエージェントに現在デプロイされているストリーミング取り込みとレプリケーションジョブのリストを表示します。 | infa/stream :>task-list 6e61e76f-2618-4292-ab3d-dd181f47ee91 ad5053c7-5ac2-493f-8cbb-a24900b61f71 |
task-health | ストリーミングエージェントのすべてのストリーミング取り込みとレプリケーションジョブの正常性のステータスを表示します。 --nameオプションまたは--idオプションを使用してジョブを指定します。 何も指定されていない場合は、すべてのジョブのリストが表示されます。 | infa/stream :>task-health --name aby_df4 processors : [{"id":"14a7a095-7fac-4fc3-ac5c-705369132516","status":"ERROR"},{"id":"821e6730-3aed-4d3f-b875-45f424b6b963","status":"RUNNING"}] status : ERROR timestamp : Sat May 09 06:04:08 IST 2020 infa/stream :>task-health 6e61e76f-2618-4292-ab3d-dd181f47ee91 processors : [{"id":"2a0b8715-aa7a-46c5-9d6a-6a356f5a0102","status":"ERROR"},{"id":"1172f3a8-35dd-41ef-be4b-bc0cf37e3794","status":"RUNNING"}] status : ERROR timestamp : Sat May 09 06:04:08 IST 2020 ad5053c7-5ac2-493f-8cbb-a24900b61f71 processors : [{"id":"14a7a095-7fac-4fc3-ac5c-705369132516","status":"ERROR"},{"id":"821e6730-3aed-4d3f-b875-45f424b6b963","status":"RUNNING"}] status : ERROR timestamp : Sat May 09 06:04:08 IST 2020 |
task-metadata | ストリーミングエージェントのすべてのストリーミング取り込みとレプリケーションジョブのメタデータを表示します。 --nameオプションまたは--idオプションを使用してジョブを指定します。 何も指定されていない場合は、すべてのジョブのリストが表示されます。 | infa/stream :>task-metadata --name aby_df4 id : ad5053c7-5ac2-493f-8cbb-a24900b61f71 name : aby_df4 runId : 9071 version : 1 infa/stream :>task-metadata 6e61e76f-2618-4292-ab3d-dd181f47ee91 id : 6e61e76f-2618-4292-ab3d-dd181f47ee91 name : aby_df2 runId : 9069 version : 8 ad5053c7-5ac2-493f-8cbb-a24900b61f71 id : ad5053c7-5ac2-493f-8cbb-a24900b61f71 name : aby_df4 runId : 9071 version : 1 |
task-statistics | ストリーミングエージェントのすべてのストリーミング取り込みとレプリケーションジョブの統計の詳細を表示します。 --nameオプションまたは--idオプションを使用してジョブを指定します。 何も指定されていない場合は、すべてのジョブのリストが表示されます。 | infa/stream :>task-statistics --name aby_df1 dataflow name : aby_df1 last time collected : 1590861803731 last time posted : 1590861806091 infa/stream :>task-statistics 7b7d3c09-df43-482f-b6c8-8dd80187e6d7 dataflow name : aby_df2 last time collected : 1590861770731 last time posted : 1590861741132 decfad0a-20df-4226-84f9-1ff1ab6ef96a dataflow name : aby_df1 last time collected : 1590861768730 last time posted : 1590861771054 |