Bigtable
Bigtable コネクタを使用すると、Bigtable データに対して挿入、削除、更新、読み取りのオペレーションを実行できます。
サポート対象のバージョン
このコネクタは Google Bigtable バージョン 2 をサポートしています。
始める前に
Bigtable コネクタを使用する前に、プロジェクトで次の操作を行います。 Google Cloud
- ネットワーク接続が設定されていることを確認します。ネットワーク パターンの詳細については、Network Connectivity をご覧ください。
- コネクタを構成するユーザーに roles/connectors.admin IAM ロールを付与します。
- コネクタに使用するサービス アカウントに、
roles/secretmanager.viewerとroles/secretmanager.secretAccessorの IAM ロールを付与します。 - 次のサービスを有効にします。
secretmanager.googleapis.com（Secret Manager API）connectors.googleapis.com（Connectors API）
サービスを有効にする方法については、サービスを有効にするをご覧ください。以前にプロジェクトでこうしたサービスを有効にしていない場合は、コネクタを構成するときに有効にするよう求められます。
コネクタを構成する
接続はデータソースに特有です。つまり、多数のデータソースがある場合は、データソースごとに別々の接続を作成する必要があります。接続を作成する手順は次のとおりです。
- Cloud コンソールで、[Integration Connectors] > [接続] ページに移動し、Google Cloud プロジェクトを選択または作成します。
- [+ 新規作成] をクリックして [接続の作成] ページを開きます。
- [ロケーション] セクションで、接続のロケーションを選択します。
- リージョン: プルダウン リストからロケーションを選択します
サポートされているすべてのリージョンのリストについては、ロケーションをご覧ください。
- [NEXT] をクリックします。
- リージョン: プルダウン リストからロケーションを選択します
- [接続の詳細] セクションで、次の操作を行います。
- コネクタ: 使用可能なコネクタのプルダウン リストから [Bigtable] を選択します。
- コネクタのバージョン: 使用可能なバージョンのプルダウン リストからコネクタのバージョンを選択します。
- [接続名] フィールドに、接続インスタンスの名前を入力します。
接続名は次の条件を満たす必要があります。
- 接続名には英字、数字、ハイフンを使用できます。
- 文字は小文字のみを使用できます。
- 接続名の先頭には英字を設定し、末尾には英字または数字を設定する必要があります。
- 接続名は 49 文字以内で指定してください。
- 必要に応じて、接続インスタンスの [説明] を入力します。
- 必要に応じて、Cloud Logging を有効にして、ログレベルを選択します。デフォルトのログレベルは
Errorに設定されています。 - サービス アカウント: 必要なロールを持つサービス アカウントを選択します。
- プロジェクト ID: Bigtable インスタンスを含むプロジェクトの ID。
- インスタンス ID: Bigtable インスタンス ID。
- 接続プールサイズ: Bigtable の接続プールサイズ。
- 必要に応じて、接続ノードの設定を構成します。
- ノードの最小数: 接続ノードの最小数を入力します。
- ノードの最大数: 接続ノードの最大数を入力します。
ノードは、トランザクションを処理する接続の単位（またはレプリカ）です。1 つの接続でより多くのトランザクションを処理するには、より多くのノードが必要になります。逆に、より少ないトランザクションを処理するには、より少ないノードが必要になります。ノードがコネクタの料金に与える影響については、接続ノードの料金をご覧ください。値を入力しない場合は、デフォルトで最小ノード数は 2 に設定され（可用性を高めるため）、最大ノード数は 50 に設定されます。
- 必要に応じて、[+ ラベルを追加] をクリックして Key-Value ペアの形式でラベルを接続に追加します。
- [NEXT] をクリックします。
-
[認証] セクションで、認証の詳細を入力します。
- [認証タイプ] を選択し、関連する詳細を入力します。
Bigtable 接続でサポートされる認証タイプは次のとおりです。
- サービス アカウント認証
- OAuth 2.0 - 認証コード
- [NEXT] をクリックします。
これらの認証タイプの構成方法については、認証を構成するをご覧ください。
- [認証タイプ] を選択し、関連する詳細を入力します。
- Review: 接続と認証の詳細を確認します。
- [作成] をクリックします。
認証を構成する
使用する認証に基づいて詳細を入力します。
- サービス アカウントの認証: サービス アカウントに必要なロールがあることを確認します。
-
OAuth 2.0 - 認証コード
- クライアント ID: アプリケーションによって提供されるクライアント ID。
- スコープ: 必要なスコープのリスト
- クライアント シークレット: アプリケーションのクライアント シークレットを含む Secret Manager のシークレット。
- シークレット バージョン: 上で選択したシークレットのシークレット バージョン。
接続構成のサンプル
このセクションでは、接続を作成するときに構成するさまざまなフィールドのサンプル値を示します。
サービス アカウント認証接続タイプ
| フィールド名 | 詳細 |
|---|---|
| 場所 | asia-east1 |
| バージョン | 1 |
| コネクタ | bigtable |
| コネクタのバージョン | 1 |
| 接続名 | googlecloud-bigtable-service-authontication |
| Service Account | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| プロジェクト ID | PROJECT_ID |
| インスタンス ID | gcloud-bigtable-instance |
| 接続プールサイズ | 1 |
| ノードの最小数 | 2 |
| ノードの最大数 | 50 |
| クライアント シークレット | bigtable-client-secret |
| シークレット バージョン | 1 |
OAuth 2.0 - 認証コードの接続タイプ
| フィールド名 | 詳細 |
|---|---|
| 場所 | asia-east1 |
| バージョン | 1 |
| コネクタ | bigtable |
| コネクタのバージョン | 1 |
| 接続名 | bigtable-oauth |
| Service Account | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
| プロジェクト ID | PROJECT_ID |
| インスタンス ID | googlecloud-bigtable-instance |
| 接続プールサイズ | 1 |
| ノードの最小数 | 2 |
| ノードの最大数 | 50 |
| クライアント シークレット | bigtable-client-secret |
| シークレット バージョン | 1 |
システムの上限
Bigtable コネクタは、ノードごとに 1 秒あたり最大 16 件のトランザクションを処理することができ、この上限を超えるトランザクションはすべてスロットルされます。デフォルトでは、Integration Connectors は、接続に 2 つのノードを割り当てます（可用性を高めるため）。
Integration Connectors に適用される上限の詳細については、上限をご覧ください。
統合で Bigtable 接続を使用する
接続を作成すると、Apigee Integration と Application Integration の両方で使用できるようになります。この接続は、コネクタタスクを介して統合で使用できます。
- Apigee Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
- Application Integration で Connectors タスクを作成して使用する方法については、Connectors タスクをご覧ください。
エンティティ、オペレーション、アクション
すべての Integration Connectors が、接続されたアプリケーションのオブジェクトを抽象化するレイヤを提供します。アプリケーションのオブジェクトには、この抽象化を通じてのみアクセスできます。抽象化は、エンティティ、オペレーション、アクションとして公開されます。
- エンティティ: エンティティは、接続されているアプリケーションやサービスのオブジェクト、またはプロパティのコレクションと考えることができます。エンティティの定義は、コネクタによって異なります。たとえば、データベース コネクタでは、テーブルがエンティティであり、ファイル サーバー コネクタでは、フォルダがエンティティです。また、メッセージング システム コネクタでは、キューがエンティティです。
ただし、コネクタでいずれのエンティティもサポートされていない、またはエンティティが存在しない可能性があります。その場合、
Entitiesリストは空になります。 - オペレーション: エンティティに対して行うことができるアクティビティです。エンティティに対して次のいずれかのオペレーションを行うことができます。
使用可能なリストからエンティティを選択すると、そのエンティティで使用可能なオペレーションのリストが生成されます。オペレーションの詳細については、コネクタタスクのエンティティ オペレーションをご覧ください。ただし、コネクタがいずれかのエンティティ オペレーションをサポートしていない場合、サポートされていないオペレーションは
Operationsリストに含まれません。 - アクション: コネクタ インターフェースを介して統合で使用できる主要な関数の一つです。アクションを使用すると、1 つまたは複数のエンティティに対して変更を加えることができます。また、使用できるアクションはコネクタごとに異なります。通常、アクションには入力パラメータと出力パラメータがあります。ただし、コネクタがどのアクションもサポートしていない可能性があります。その場合は、
Actionsリストが空になります。
エンティティ オペレーションの例
このセクションでは、このコネクタでエンティティ オペレーションの一部を実行する方法について説明します。
例 - テーブルからレコードを取得する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityリストからTableを選択します。- [
Get] オペレーションを選択し、[完了] をクリックします。 - エンティティ ID を「Get Operation」に設定します。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに
row99を入力し、EntityId をローカル変数として選択します。
例 - テーブルのすべてのレコードを一覧表示する
- [
Configure connector task] ダイアログで、[Entities] をクリックします。 EntityリストからTableを選択します。- [
List] オペレーションを選択し、[完了] をクリックします。
例 - テーブルにレコードを作成する
- [
Configure connector task] ダイアログで、[Entities and select Table2] をクリックします。 - [
Create] オペレーションを選択し、[完了] をクリックします。 - RowKey を Create オペレーションに設定します。RowKey を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに
例 - テーブル内のレコードを更新する
- [
Configure connector task] ダイアログで、[Entities and select Table] をクリックします。 - [
Update] オペレーションを選択し、[完了] をクリックします。 - エンティティ ID を更新オペレーションに設定します。エンティティ ID を設定するには、[データ マッピング] の [データマッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに
を入力し、列ファミリーの RowKey とペイロードをローカル変数として指定します。
例 - テーブルからレコードを削除する
- [
Configure connector task] ダイアログで、[Entities and select Table2] をクリックします。 - [
Delete] オペレーションを選択し、[完了] をクリックします。 - エンティティ ID を「削除オペレーション」に設定します。エンティティ ID を設定するには、[データ マッピング] の [データ マッパー] セクションで [データ マッピング エディタを開く] をクリックし、[入力値] フィールドに
row99を入力し、EntityId をローカル変数として選択します。
Google Cloud コミュニティの助けを借りる
Google Cloud コミュニティの Cloud フォーラムで質問を投稿したり、このコネクタについてディスカッションしたりできます。次のステップ
- 接続を一時停止して再開する方法を確認する。
- コネクタの使用状況をモニタリングする方法を確認する。
- コネクタログを表示する方法を確認する。