コネクタと接続 > データ取り込みおよびレプリケーション接続プロパティ > SAP HANA Database Ingestion接続のプロパティ
  

SAP HANA Database Ingestion接続のプロパティ

SAP HANAデータベース取り込み接続を定義するには、接続プロパティを設定します。この接続タイプは、データ取り込みおよびレプリケーションで設定したデータベース取り込みとレプリケーションタスクのソースに使用することができます。
以下の表に、SAP HANA接続のプロパティを示します。
接続プロパティ
説明
接続名
接続の名前。この名前は、組織内で一意にする必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_ .+ -
名前の先頭または末尾のスペースはトリミングされ、名前の一部として保存されません。最大長は100文字です。接続名では大文字と小文字は区別されません。
説明
接続の説明(オプション)。最大長は255文字です。
ランタイム環境
データベース取り込みとレプリケーションタスクを実行するランタイム環境の名前。ランタイム環境は、管理者で定義します。
ローカルのSecure Agentインストールまたはサーバーレスランタイム環境のいずれかを使用できます。初期ロードに限り、クラウドソースタイプに対してサーバーレスランタイム環境を使用できます。ホステッドエージェントまたはエラスティックランタイム環境で、データベース取り込みとレプリケーションタスクを実行することはできません。
ユーザー名
SAP HANAインスタンスに接続するためのユーザー名。SAP HANAで指定されているデータベースユーザー名と同じ大文字と小文字を使用してユーザー名を入力します。
パスワード
SAP HANAインスタンスに接続するためのパスワード。
ホスト
SAP HANAデータベースサーバーをホストするマシンの名前。
ポート
接続先のSAP HANAサーバーのポート番号。デフォルトは30015です。
データベース名
SAP HANAソースデータベース名。
詳細接続プロパティ
SAP HANAソースへの接続に使用されるSAP HANA JDBCドライバのオプションの詳細プロパティ。property=valueエントリを複数指定する場合は、アンパサンド(&)で区切ります。このフィールドに入力できるJDBC接続プロパティについては、SAPのJDBC Connection Propertiesのドキュメントを参照してください。例: encrypt=true。
キャプチャタイプ
次のいずれかのオプションを選択して、データベース取り込み増分ロードジョブがSAP HANAデータベースから変更データをキャプチャするために使用するキャプチャメソッドを指定します。
  • - トリガベース。AFTER DELETE、AFTER INSERT、AFTER UPDATEトリガを使用して、スキーマ内のSAP HANAソーステーブルから変更データをキャプチャします。トリガは、各ソーステーブルのDML変更の操作前イメージと操作後イメージを取得し、変更のエントリをPKLOGテーブルとシャドー_CDCテーブルに書き込みます。
  • - ログベース。SAP HANAデータベースログから変更データをキャプチャします。
  • 注:
    ログベースのキャプチャタイプを使用するには、組織にフラグを設定する必要があります。このオプションを選択できない場合は、Informaticaグローバルカスタマサポートにお問い合わせください。
デフォルトは[トリガベース]です。
ログのクリア
増分ロードの場合は必須です。キャプチャタイプに応じて、このプロパティを次のように設定します。
  • - [トリガベース]変更キャプチャの場合、PKLOGテーブルエントリとシャドー_CDCテーブルエントリがパージされるまでの時間間隔(日数)を入力します。パージは、増分ロードジョブの実行中にのみ行われます。
  • データベース取り込みジョブの有効な値は0から366です。この範囲の正の値を指定すると、増分ジョブの実行中に自動ハウスキーピングが実行されます。デフォルトは14です。
    値0は、テーブルエントリがパージされないことを意味します。手動でハウスキーピングを行う場合は、0を入力して社内プロセスを使用してください。
    負の数または数値以外の値を含め、0から366の範囲外の値があると、接続を使用するデータベース取り込みジョブが次のエラーで失敗します。
    LogClear contains a non numeric number. Caused by: LogClear contains a non numeric number.
  • - [ログベース]変更キャプチャの場合、HANAまたはOracleデータベースキャッシュに格納されているデータレコードが圧縮されるまでの日数を入力します。この時間間隔に達すると、レコードが圧縮されますが、削除はされません。デフォルトは14です。値0は、圧縮が発生しないことを表します。実質的には、最大値はありません。
トリガプレフィックス
[トリガベース]キャプチャタイプの場合、DML変更の操作前と操作後のイメージを取得するためにCDCスクリプトが各ソーステーブルに対して生成するAFTER DELETE、AFTER INSERT、およびAFTER UPDATEトリガの名前にプレフィックスを追加できます。最大16文字のプレフィックス値を入力します。トリガ名のプレフィックスの後にアンダースコア(_)が続きます(例: TX_SAP_DEMO_TABLE_DBMI_USER_t_d)。プレフィックスを使用して、サイトのトリガ命名規則に準拠できます。
キャッシュタイプ
[ログベース]キャプチャタイプの場合、キャッシュタイプとして[HANA]または[Oracle]を選択します。Secure Agentは、変更レコードをターゲットに書き込む準備が整うまで、変更データをキャッシュに保存します。
キャッシュホスト
[ログベース]キャプチャタイプの場合は、キャッシュデータベースをホストするマシンのホスト名を入力します。
キャッシュポート
[ログベース]キャプチャタイプの場合は、キャッシュデータベースサーバーのポート番号を入力します。
キャッシュユーザー名
[ログベース]キャプチャタイプの場合は、キャッシュデータベースへの接続に使用するユーザー名を入力します。
キャッシュパスワード
[ログベース]キャプチャタイプの場合は、キャッシュデータベースへの接続に使用するパスワードを入力します。
キャッシュデータベース/サービス名
[ログベース]キャプチャタイプの場合は、選択したキャッシュタイプに応じて、HANAキャッシュデータベース名またはOracleキャッシュサービス名を入力します。
キャッシュ追加接続プロパティ
[ログベース]キャプチャタイプの場合は、オプションのキャッシュ接続プロパティのリストを入力できます。HANAキャッシュを使用する場合は、アンパサンド(&)区切り記号を使用します。Oracleキャッシュを使用する場合は、セミコロン(;)区切り記号を使用します。
例:
HANA: latency=0&communicationtimeout=0
Oracle: EncryptionMethod=SSL;CryptoProtocolVersion=TLSv1.1
キャッシュセキュリティ接続プロパティ
[ログベース]キャプチャタイプの場合は、キャッシュ接続のオプションのセキュリティプロパティのリストを入力できます。HANAキャッシュを使用する場合は、アンパサンド(&)区切り記号を使用します。Oracleキャッシュを使用する場合は、セミコロン(;)区切り記号を使用します。
例:
HANA: encrypt=true&validateCertificate=false
Oracle: KeyStorePassword=xyz;TrustStorePassword=xy
サーバーログのパス
[ログベース]キャプチャタイプの場合は、SAP HANAデータベースサーバーのログパスを入力します。
クライアントログのパス
[ログベース]キャプチャタイプの場合は、ソースデータベースのログの場所へのSecure Agentマシンのマウントパスのマッピングを入力します。
クライアントアーカイブログのパス
[ログベース]キャプチャタイプの場合は、ソースデータベースのアーカイブログの場所へのSecure Agentマシンのマウントパスのマッピングを入力します。
キーバックアップパスワード
暗号化されたSAP HANAログファイルで[ログベース]キャプチャタイプを使用している場合は、オンラインREDOログとアーカイブログの復号に必要なキーを含む暗号化ルートキーファイルへのアクセス用にSAP HANAで作成または生成したパスワードを入力してください。
注:
ログベースのキャプチャタイプ(暗号化ログの有無を問わず)を使用するには、組織にフラグを設定する必要があります。ログベースのキャプチャを選択できない場合は、Informaticaグローバルカスタマサポートにお問い合わせください。
また、暗号化されたログファイルから変更データを取得するには、[キーバックアップデータパス]プロパティを指定する必要があります。これらのフィールドのうち1つだけが設定されている場合、ジョブのデプロイメントは失敗します。両方のフィールドが設定されていない場合、データベースの取り込みおよびレプリケーションではログが暗号化されていないとみなされます。
キーバックアップデータのパス
暗号化されたSAP HANAログファイルで[ログベース]キャプチャタイプを使用している場合は、CDC処理用にオンラインREDOログとアーカイブログを復号するために必要なキーを含む暗号化ルートキーファイルへのパスを入力してください。このファイルはSecure Agentマシン上に存在している必要があります。Secure Agentグループでは、このファイルは同じファイル名のグループ内のそれぞれのSecure Agentマシンに存在している必要があります。
注:
ログベースのキャプチャタイプ(暗号化ログの有無を問わず)を使用するには、組織にフラグを設定する必要があります。ログベースのキャプチャを選択できない場合は、Informaticaグローバルカスタマサポートにお問い合わせください。
また、暗号化されたログファイルから変更データを取得するには、[キーバックアップパスワード]プロパティを指定する必要があります。これらのフィールドのうち1つだけが設定されている場合、ジョブのデプロイメントは失敗します。両方のフィールドが設定されていない場合、データベースの取り込みおよびレプリケーションではログが暗号化されていないとみなされます。
注:
接続をテストしてテストが失敗した場合は、SAP HANA JDBCドライバファイルngdbc.jarが<Secure Agent installation directory>/ext/connectors/thirdparty/informatica.hanamiにインストールされていることを確認してください。

サーバーレスランタイム環境の使用

データ取り込みおよびレプリケーションでは、Azureでホストされているサーバーレスランタイム環境を使用してSAP HANAデータベースに接続できます。
サーバーレスランタイム環境を使用してSAP HANA Database Ingestion接続を設定する前に、次のタスクを実行してください。
AzureアカウントのAzureコンテナにJDBCドライバをJARファイルとして追加
以下の手順を実行します。
  1. 1Azureのサーバーレスエージェント設定用に次の構造を作成します: <Supplementary file location>/serverless_agent_config/
  2. 2Azureアカウントの次の場所にあるAzureコンテナにJDBCドライバファイルを追加します:
  3. <補足ファイルの場所>/serverless_agent_config/hanami
.ymlサーバーレス構成ファイルを設定する
サーバーレスランタイム環境で.ymlサーバーレス構成ファイルを設定するには、次の手順を実行します。
  1. 1次のコードスニペットをテキストエディタにコピーし、ドライバファイル名を指定します。
  2. version: 1
    agent:
    databaseIngestion:
    autoDeploy:
    hanami:
    drivers:
    - fileCopy:
    sourcePath: hanami/<file_name>.jar
    ここで、sourcePathはAzureのドライバファイルのディレクトリパスです。
  3. 2構文とインデントが有効であることを確認してから、ファイルをserverlessUserAgentConfig.ymlとして次のAzureの場所に保存します: <補足ファイルの場所>/serverless_agent_config
  4. .ymlファイルが実行されると、JDBCドライバファイルがAzureの場所から次のサーバーレスエージェントディレクトリにコピーされます: <AGENT_DIR>/ext/connectors/thirdparty/informatica.hanami