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

Google BigQuery V2接続のプロパティ

Google BigQueryとの間でデータの安全な読み取りまたは書き込みを行うためのGoogle BigQuery V2接続を作成します。

Google BigQueryへの接続

Google BigQueryに接続するようにGoogle BigQuery V2接続プロパティを設定してみましょう。

始める前に

接続を設定する前に、GoogleサービスアカウントキーファイルをJSON形式でダウンロードしてください。サービスアカウントキーファイルは、Googleサービスアカウントの作成時に作成されます。

Google BigQuery接続を作成するには、サービスアカウントキーJSONファイルに含まれるクライアントの電子メール、プライベートキー、およびプロジェクトIDが必要です。

接続の詳細

次の表に、基本接続プロパティを示します。

プロパティ	説明
接続名	接続の名前。各接続名は組織内で一意である必要があります。接続名には、英数字、スペース、および次の特殊文字を含めることができます。_ .+ -, 最大長は255文字です。
説明	接続の説明。最大長は4000文字です。
シークレットコンテナの使用	組織に対して設定されているSecrets Managerにこの接続の機密資格情報を保存します。このプロパティは、組織にSecrets Managerが設定されている場合にのみ表示されます。このプロパティは、データ取り込みおよびレプリケーションとデータアクセス管理サービスではサポートされていません。接続でシークレットコンテナを有効にすると、Secure AgentがSecrets Managerからどの資格情報を取得するかを選択できます。このオプションを無効にした場合、資格情報は組織の設定方法に応じてリポジトリまたはローカルSecure Agentに保存されます。注: この接続を使用してプッシュダウンまたはプロキシサービスを介してデータアクセスポリシーを適用する場合、シークレットコンテナ設定オプションを使用することはできません。 Secrets Managerを設定および使用する方法については、Secrets manager configurationを参照してください。
ランタイム環境	タスクを実行するランタイム環境の名前。アプリケーション取り込みとレプリケーションタスクとデータベース取り込みとレプリケーションタスクでは、Secure Agentまたはサーバーレスランタイム環境を使用できます。タスクには、サーバーレス使用がサポートされているソースタイプが必要です。ホステッドエージェントまたはエラスティックランタイム環境で、アプリケーション取り込みとレプリケーションタスク、データベース取り込みとレプリケーションタスク、ファイル取り込みおよびレプリケーションタスク、またはストリーミング取り込みとレプリケーションタスクを実行することはできません。

認証タイプ

サービスアカウント認証方式またはWorkload Identity連携認証方式を設定して、Google BigQueryにアクセスすることができます。Workload Identity連携認証方式を使用する場合は、OktaをIDプロバイダとして設定できます。

必要な認証方式を選択し、認証固有のパラメータを設定します。

デフォルトはサービスアカウント認証方式です。

サービスアカウント認証

サービスアカウント認証では、少なくともGoogle BigQueryサービスアカウントの電子メール、サービスアカウントキー、およびプロジェクトIDが必要です。

次の表に、サービスアカウント認証の基本接続プロパティを示します。

プロパティ	説明
サービスアカウントの電子メール	GoogleサービスアカウントキーJSONファイルのclient_email値。
サービスアカウントキー	GoogleサービスアカウントキーJSONファイルのprivate_key値。 JSONファイルから取得したプライベートキーを使用する場合は、private_keyフィールドの二重引用符内にある、-----BEGIN PRIVATE KEY-----\nで始まって-----END PRIVATE KEY-----\nで終わるテキストブロック全体を入力します。
プロジェクトID	GoogleサービスアカウントキーJSONファイルのproject_id値。同じサービスアカウントを使用して複数のプロジェクトを作成した場合は、接続先のデータセットが含まれるプロジェクトのIDを入力します。

注:

テスト接続中にサービスアカウントの電子メール、サービスアカウントキー、およびプロジェクトIDの資格情報を検証する場合は、詳細設定の［オプションのプロパティの指定］フィールドでフラグCredentialValidation:trueを設定します。

詳細設定

次の表に、サービスアカウント認証の詳細接続プロパティを示します。

プロパティ	説明
ストレージパス	データを一時的に格納するためにエージェントがローカルステージファイルを作成する、Google Cloud Storage内のパス。エージェントは、ステージングモードでデータを読み取る場合、またはバルクモードでデータを書き込む場合に、このストレージを使用します。次のいずれかの形式を使用します。 - gs://<bucket_name> - gs://<bucket_name>/<folder_name> Google BigQueryでのクロスリージョンレプリケーションを有効にする場合、デュアルリージョンストレージをサポートするGoogle Cloud Storageパスを入力します。
接続モード	Google BigQueryとの間でデータの読み取りまたは書き込みを行う場合に使用するモード。次のいずれかの接続モードを選択します。 - 簡易。レコードデータ型フィールド内の各フィールドがマッピング内の個別のフィールドとしてフラット化されます。 - 混合。レコードデータ型のフィールドを含むGoogle BigQueryテーブル内のすべての最上位のフィールドを表示します。Google BigQuery V2コネクタに、最上位のレコードデータ型のフィールドがマッピング内の文字列データ型の単一のフィールドとして表示されます。 - 複合。Google BigQueryテーブル内のすべてのカラムがマッピング内の文字列データ型の単一のフィールドとして表示されます。デフォルトは［簡易］です。
カスタムクエリにレガシーSQLを使用	このオプションは、カスタムクエリを定義するためにレガシーSQLを使用する場合に選択します。標準SQLを使用してカスタムクエリを定義する場合は、このオプションをオフにします。このプロパティは、Google BigQuery V2接続を混合モードまたは複合モードで設定した場合には適用されません。
カスタムクエリのデータセット名	カスタムクエリで指定するGoogle BigQueryデータセットの名前。
スキーマ定義のファイルパス	Secure AgentによってGoogle BigQueryテーブルのサンプルスキーマとともにJSONファイルが作成される、Secure Agentマシン上のディレクトリ。JSONファイル名は、Google BigQueryテーブル名と同じです。または、Secure AgentによってGoogle BigQueryテーブルのサンプルスキーマとともにJSONファイルが作成される、Google Cloud Storage内のストレージパスを指定します。JSONファイルは、Google Cloud Storage内の指定したパスからローカルマシンにダウンロードできます。複合接続モードを次のようなシナリオで設定する場合は、スキーマ定義ファイルが必要です。 - リレーショナルソースからのデータの読み取りとGoogle BigQueryターゲットへのデータの書き込みを行うために、マッピング内に階層ビルダトランスフォーメーションを追加した場合。 - Google BigQueryソースからのデータの読み取りと、リレーショナルターゲットへのデータの書き込みを行うために、マッピング内に階層パーサートランスフォーメーションを追加した場合。
リージョンID	アクセスするGoogle BigQueryデータセットが存在する地域名。注: 指定された地域に存在するバケット名またはバケット名とフォルダ名を［ストレージパス］プロパティで指定します。 Google BigQueryでサポートされる地域の詳細については、「Dataset locations」を参照してください。
ステージングデータセット	データをステージングするためのステージングテーブルを作成するGoogle BigQueryデータセット名。ソースまたはターゲットデータセットとは異なるGoogle BigQueryデータセットを定義できます。
オプションのプロパティの指定	特定のソースおよびターゲット機能を設定するための、Google BigQuery V2接続のカスタムプロパティのカンマ区切りのキーと値のペア。指定できるカスタムプロパティのリストの詳細については、次のナレッジベースの記事を参照してください: Optional Properties configuration

プロキシサーバーの設定

組織で送信プロキシサーバーを使用してインターネットに接続している場合、Secure Agentはプロキシサーバー経由でInformatica® Intelligent Data Management Cloud™（IDMC）に接続します。

WindowsおよびLinuxでプロキシサーバーを使用するようにSecure Agentを設定できます。認証されていないプロキシサーバーまたは認証されたプロキシサーバーを使用できます。

Secure Agentのプロキシの設定を行うには、次のタスクを実行します。

•Windowsの場合はSecure Agent Managerを使用し、Linuxの場合はシェルコマンドを使用してSecure Agentを設定します。

手順については、データ統合のヘルプの『基本操作Configure the proxy settings on Windows』にある、Configure the proxy settings on Linuxまたは

•Secure Agentのプロパティで、DTMのJVMオプションを設定します。手順については、ナレッジベースの記事「Proxy server settings」を参照してください。

proxy.ini構成ファイルで指定したプロキシ設定は設計時に適用され、JVMオプションを使用して指定したプロキシ設定は実行時に適用されます。

NTLM認証用のプロキシの設定

NTLM認証を使用するプロキシサーバーを使用して、Google BigQueryに接続できます。NTLM認証用のプロキシの設定を行うには、次の手順を実行します。

1管理者で、［ランタイム環境］を選択します。
2利用可能なSecure Agentのリストから、設定するSecure Agentを選択します。
3右上隅の［編集］をクリックします。
4［システム構成の詳細］セクションで、データ統合サーバーの［タイプ］に［DTM］を選択します。
5［JVMOption1］を編集し、次の値を追加します。

-Dhttp.auth.ntlm.domain=<domain name>

6データ統合サーバーの［プラットフォーム］として［タイプ］を選択します。
7［INFA_DEBUG］プロパティを編集し、次の値を追加します。

-Dhttp.auth.ntlm.domain=<domain name>

8［保存］をクリックします。
9Secure Agentを再起動します。