Dataplex Universal Catalog を使用して AlloyDB リソースを管理する

AlloyDB for PostgreSQL リソースを検索して管理するには、Dataplex Universal Catalog を使用できます。これは、メタデータを保存、管理、アクセスするためのプラットフォームです。Dataplex Universal Catalog を使用すると、AlloyDB メタデータを検出して把握できます。Dataplex Universal Catalog を使用して、以下を行うことができます。

分析（依存関係やユースケースへの適合性など）
チェンジマネジメント
スキーマ進化

Dataplex Universal Catalog は、AlloyDB から次のメタデータを自動的に取得します。

リソースの種類	取得したメタデータ
クラスタ、データベース、インスタンス	名前ロケーション（リージョン）
スキーマ、列、テーブル、ビュー	名前ロケーション（リージョン）説明スキーマ

リソースの種類

取得したメタデータ

クラスタ、データベース、インスタンス

名前

ロケーション（リージョン）

スキーマ、列、テーブル、ビュー

名前

ロケーション（リージョン）

説明

スキーマ

メタデータ検出の種類

Dataplex Universal Catalog のコンテキストにおいて、メタデータ検出とは、Dataplex Universal Catalog が接続されたデータソース（AlloyDB など）をスキャンして、データアセット（テーブル、ビュー、データベースなど）を特定し、そのテクニカルメタデータ（スキーマ、説明、ロケーションなど）をカタログに抽出する自動プロセスのことです。

このプロセスは定期的に実行され、カタログとソースシステムの同期を維持します。AlloyDB の場合、クラスタとインスタンスのメタデータはデフォルトで検出されますが、データベース、スキーマ、テーブル、ビューのメタデータは、クラスタでインテグレーションを有効にした場合にのみ検出されます。

キーワード検索と自然言語検索

Dataplex Universal Catalog では、キーワード検索と自然言語検索をサポートしています。

キーワード検索では、特定のキーワード、フィルタ、定義された構文を使用してリソースを検索できます。たとえば、「system=AlloyDB AND type=Database」と入力すると、すべての AlloyDB データベースが表示されます。
自然言語検索（プレビュー）は、AI を使用してセマンティッククエリを理解します。普段使う言葉でリソースを検索できるため、複雑な構文を使用する必要はありません。たとえば、「List all AlloyDB tables related to sales」などのクエリを入力できます。

詳細については、Dataplex Universal Catalog の検索構文をご覧ください。

例: AlloyDB データベーススキーマの検出

メタデータ検出プロセスを理解するために、Dataplex Universal Catalog インテグレーションが有効になっている user-data-cluster という名前の AlloyDB クラスタの例を考えてみましょう。このクラスタのプライマリインスタンス内には、profiles という名前のデータベースがあり、このデータベースにはテーブル customers（id、email、signup_date）とビュー active_users（id、email）が含まれます。

AlloyDB は Dataplex Universal Catalog に定期的に同期され、次のリソースを使用できます。

クラスタ
列
データベース
インスタンス
テーブル
ビュー

検出が完了すると、 Google Cloud コンソールの Dataplex Universal Catalog ページまたは API を使用して、これらのアセット（customers テーブルと active_users）を検索し、スキーマを表示して、追加のビジネスメタデータまたは運用メタデータで拡充できます。

アスペクトを使用してメタデータを拡充する

アスペクトタイプは、アスペクトのテンプレートとして使用できる再利用可能なリソースです。アスペクトタイプを使用すると、作業の重複や不完全なアスペクトを回避できます。Dataplex Universal Catalog を使用して、必要なアスペクトタイプを作成できます。

カスタムアスペクトタイプを作成したら、AlloyDB アセットにアスペクトを追加できます。AlloyDB アセットにアスペクトを追加すると、次のことが可能になります。

アセットにビジネスメタデータを追加する。
ビジネスメタデータやその他のカスタムメタデータでアセットを検索する。

アスペクトタイプの作成と AlloyDB へのアスペクトの追加の詳細については、アスペクトを管理してメタデータを拡充するをご覧ください。

メタデータ検出ワークフロー

クラスタとインスタンスのリソースは、デフォルトで取り込まれ、検出可能になります。データベース、スキーマ、テーブル、ビューのリソースを取り込んで検出する場合にのみ、AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを有効にする必要があります。

AlloyDB データベース、スキーマ、テーブル、ビューのリソースを検出するには、新しいクラスタの作成時または既存のクラスタの更新時に、AlloyDB API を使用して AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを有効にする必要があります。詳細については、クラスタとそのプライマリインスタンスを作成するをご覧ください。
Google Cloud コンソールの Dataplex Universal Catalog 検索ページを使用して、AlloyDB アセットを検索します。詳細については、Dataplex Universal Catalog でリソースを検索するをご覧ください。
AlloyDB アセットにコンテキストを追加するには、アセットにアスペクトを追加します。アスペクトは、データガバナンスや分析に役立つカスタムメタデータエントリです。たとえば、アスペクトを使用して、個人を特定できる情報（PII）を含む列にラベルを付けることができます。詳細については、アスペクトを管理してメタデータを拡充するをご覧ください。
AlloyDB リソース間を、クラスタ > データベース > スキーマ > テーブルまたはビュー > 列の階層で移動できるようになりました。これにより、データランドスケープを詳細に把握できます。詳細については、Dataplex Universal Catalog でリソースを検索するをご覧ください。

始める前に

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

プロジェクトで Dataplex API を有効にします。

Dataplex API を有効にする
権限を確認します。

AlloyDB アセットを検索してエントリを追加するには、特定の Identity and Access Management（IAM）のロールと権限が必要です。詳細については、Dataplex Universal Catalog に必要な IAM のロールと権限をご覧ください。

必要な IAM のロール

このセクションでは、リソースの検索と検索結果へのアクセスに必要なロールと権限について説明します。

検索結果へのアクセスに必要なロール

Dataplex Universal Catalog で AlloyDB メタデータを検索して表示するには、プリンシパルに AlloyDB リソースを表示する権限（dataplex.projects.search 権限を含む）が必要です。

プリンシパル（ユーザー、グループ、サービスアカウントなど）にこれらの権限を付与するには、AlloyDB リソースを含むプロジェクトに対する AlloyDB 閲覧者（roles/alloydb.viewer）IAM ロールを割り当てます。

Dataplex Universal Catalog のオペレーション	AlloyDB リソース	必要なロールまたは権限
AlloyDB リソースを検索する	クラスタ	`alloydb.clusters.get`
	列	`alloydb.databases.get`
	インスタンス	`alloydb.instances.get`
	データベース	`alloydb.databases.get`
	テーブル	`alloydb.databases.get`
	ビュー	`alloydb.databases.get`

AlloyDB 閲覧者の事前定義ロールを使用しない場合は、alloydb.clusters.get、alloydb.instances.get、alloydb.databases.get の権限を含むカスタムロールを割り当てることができます。

ロールの付与の詳細については、アクセス権の管理をご覧ください。AlloyDB IAM ロールの詳細については、AlloyDB の IAM ロールと権限をご覧ください。

エントリの検索に必要なロール

エントリを検索するには、検索に使用するプロジェクトに対する次の IAM ロールが 1 つ以上必要です。

Dataplex Catalog 管理者（roles/dataplex.catalogAdmin）
Dataplex Catalog 編集者（roles/dataplex.catalogEditor）
Dataplex Catalog 閲覧者（roles/dataplex.catalogViewer）

検索結果に対する権限は、選択したプロジェクトにかかわらずチェックされます。詳細については、Dataplex Universal Catalog でデータアセットを検索するをご覧ください。

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを有効にする

データベース、スキーマ、テーブル、ビューのリソースを取り込んで検出可能にするには、AlloyDB API を使用してクラスタを作成または更新します。このインテグレーションを有効にすると、データプレーンのメタデータデータベース、スキーマ、テーブル、ビューのリソースの同期が有効になります。

Dataplex Universal Catalog と統合するには、クラスタレベルの dataplexConfig フラグを使用します。セカンダリクラスタのデータを表示するには、このフラグを個別に有効にする必要があります。AlloyDB メタデータ（データベース、スキーマ、テーブルなど）の Cloud Storage バケットへのエクスポートを有効にするには、enabled を true に設定します。これにより、このデータを Dataplex Universal Catalog で使用できるようになります。この機能は、プライマリインスタンスにのみ適用されます。

クラスタの作成時に Dataplex Universal Catalog インテグレーションを有効にする

Dataplex Universal Catalog インテグレーションが有効な AlloyDB クラスタを作成するには、POST メソッドと次の URL を使用します。この呼び出しで使用できるパラメータの完全なリストについては、メソッド: projects.locations.clusters.create をご覧ください。クラスタの設定の詳細については、クラスタとインスタンスの設定を表示するをご覧ください。

クラスタ ID には機密情報や個人を特定できる情報を含めないでください。クラスタ ID は他のユーザーが閲覧できるためです。クラスタ名にプロジェクト ID を含める必要はありません。この処理は必要に応じて（ログファイルなどで）自動的に行われます。

リクエストを送信するには、リクエスト本文を cluster_request.json という名前のファイルに保存します。

{
  "databaseVersion": "DATABASE_VERSION",
  "initialUser": {
    "user": "INITIAL_USERNAME",
    "password": "INITIAL_USER_PASSWORD"
  },
  "labels": {
    "test": "alloydb-cluster-full"
  },
  "dataplexConfig" : {
    "enabled" : true
  }
}

次のように置き換えます。

DATABASE_VERSION: データベースバージョンの列挙型文字列（例: POSTGRES_16）。
INITIAL_USERNAME: デフォルトの postgres ユーザーに使用するユーザー名。
INITIAL_USER_PASSWORD: デフォルトの postgres ユーザーに使用するパスワード。

次の HTTP メソッドと URL を使用します。

POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID

次のように置き換えます。

PROJECT_ID: クラスタが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
LOCATION_ID: クラスタのリージョンの ID。
CLUSTER_ID: 作成するクラスタの ID。クラスタ ID の先頭は英小文字にする必要があり、その後に続けて英小文字、数字、ハイフンを使用できます。

次のいずれかの方法でリクエストを送信します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

    curl -X POST \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters?cluster_id=CLUSTER_ID"| Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを有効にする

既存のクラスタの特定のフィールドを更新するには、projects.locations.clusters resource で PATCH メソッドを使用します。

次の HTTP メソッドと URL を使用します。

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

次のように置き換えます。

PROJECT_ID: クラスタが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
CLUSTER_ID: クラスタの名前。

リクエストの本文（JSON）:

{
  "dataplexConfig": {
    "enabled": true
  }
}

次のいずれかの方法でリクエストを送信します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

    curl -X PATCH \
         -H "Authorization: Bearer $(gcloud auth print-access-token)" \
         -H "Content-Type: application/json; charset=utf-8" \
         -d @request.json \
        "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-09-25T22:19:33.735Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを確認する

既存のクラスタで Dataplex Universal Catalog インテグレーションが有効になっていることを確認するには、GET メソッドを使用します。

次の HTTP メソッドと URL を使用します。

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

次のように置き換えます。

PROJECT_ID: クラスタが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
CLUSTER_ID: クラスタ ID。

次のいずれかの方法でリクエストを送信します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

Cluster proto 全体の JSON レスポンスが返されます。proto 内の dataplexConfig メッセージを確認します。

{
"dataplexConfig":
  {
  "enabled": true
  }
}

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを無効にする

次の例を使用して、インテグレーションを無効にします。この機能を無効にすると、クラスタとインスタンスのメタデータのみが使用可能になります。

次の HTTP メソッドと URL を使用します。

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID

次のように置き換えます。

PROJECT_ID: クラスタが含まれている Google Cloud プロジェクトの ID またはプロジェクト番号。
CLUSTER_ID: クラスタ ID。

リクエストの本文（JSON）:

{
  "dataplexConfig": {
    "enabled": false
  }
}

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"

PowerShell（Windows）

リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

次のような JSON レスポンスが返されます。

レスポンス

{
  "kind": "alloydb#operation",
  "targetLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/clusters/CLUSTER_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2024-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "CLUSTER_ID",
  "selfLink": "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

アスペクトを使用して AlloyDB アセットを拡充する

アセットにビジネスメタデータを追加する。
ビジネスメタデータやその他のカスタムメタデータでアセットを検索する。

アスペクトタイプの作成と AlloyDB へのアスペクトの追加の詳細については、アスペクトを管理してメタデータを拡充するをご覧ください。

AlloyDB アセットを検索する

Google Cloud コンソールの Dataplex Universal Catalog 検索ページを使用して、AlloyDB アセットを検索します。

Dataplex Universal Catalog の [検索] ページに移動します。

[検索] に移動
[検索プラットフォームの選択] で、[Dataplex Universal Catalog] を選択します。
[フィルタ] パネルで [システム] をクリックし、[AlloyDB] を選択します。
省略可。[タイプエイリアス] で、次のいずれかのタイプエイリアスを選択すると、特定のタイプの AlloyDB アセットで検索結果をフィルタできます。
- データベース
- データベーススキーマ
- クラスタ
- インスタンス
- サービス
- テーブル
- ビュー
注: サービスは、AlloyDB インスタンスのタイプエイリアスです。

クエリを使用してキーワード検索を行う

Dataplex Universal Catalog の検索フィールドを使用して、キーワード検索クエリを実行できます。たとえば、「system=AlloyDB AND type=Database」と入力すると、すべての AlloyDB データベースが表示されます。

詳細については、Dataplex Universal Catalog の検索構文をご覧ください。

すべての AlloyDB アセットを表示するには、「system=AlloyDB」と入力します。

次に、特定のキーワードを入力します。たとえば、すべての AlloyDB データベースを表示するには、次のクエリを入力します。

system=AlloyDB AND type=Database

すべての AlloyDB テーブルを表示するには、次のクエリを入力します。

system=AlloyDB AND type=Table

複雑な式では、かっこと論理演算子（AND、OR）を使用することもできます。検索フィールドで使用できる式の詳細については、Dataplex Universal Catalog の検索構文をご覧ください。

検索フィールドに、特定の AlloyDB アセットの検索クエリを直接入力できます。クエリ文字列の形式は次のとおりです。

type="projects/dataplex-types/locations/global/entryTypes/QUERY_STRING"

次のように置き換えます。

QUERY_STRING: 次のリストを使用して、クエリする AlloyDB アセットタイプに応じたクエリ文字列を特定します。
- alloydb-database
- alloydb-cluster
- alloydb-instance
- alloydb-table
- alloydb-schema
- alloydb-view

クエリの例を次に示します。

type="projects/1234567890/locations/global/entryTypes/alloydb-cluster"

アスペクトタイプで検索する

Dataplex Universal Catalog には、検索に使用できる組み込みのアスペクトタイプがいくつかあります。

アスペクトタイプで検索する手順は次のとおりです。

[アスペクト] パネルで、[アスペクトタイプを追加] メニューをクリックします。
省略可。[AlloyDB Access] を選択して、AlloyDB 言語で結果をフィルタします。
次のアスペクトタイプを 1 つ以上選択して、検索結果をそのタイプに絞り込みます。
- AlloyDB データベース
- AlloyDB クラスタ
- AlloyDB インスタンス
- AlloyDB ビュー
- AlloyDB スキーマ
- AlloyDB テーブル
[OK] をクリックします。
結果のテーブルでアセットの名前をクリックすると、そのアセットのメタデータが表示されます。
省略可: アセットを拡充または表示します。次の操作を行うことができます。
- アセットのリッチテキストによる説明を追加するには、[概要] で [追加] をクリックします。
- アセットにアスペクトを追加するには、[アスペクト] で [追加] をクリックします。
- インスタンスのメンバーデータベースを表示するには、[エントリリスト] タブをクリックし、[検索結果の子エントリをすべて表示] をクリックします。[エントリリスト] タブが表示されない場合、そのクラスタにはデータベースがありません。
- [エンティティの詳細] で、アセットの詳細を確認します。エントリ名をクリックして、他のエントリにドリルダウンします。

AlloyDB の自然言語検索

自然言語検索（プレビュー）は、AI を使用してセマンティッククエリを理解します。普段使う言葉でリソースを検索できるため、複雑な構文を使用する必要はありません。たとえば、「List all AlloyDB tables related to sales」などのクエリを入力できます。

詳細については、Dataplex Universal Catalog の検索構文をご覧ください。

AlloyDB の構文検索

キーワード検索では、特定のキーワード、フィルタ、定義された構文を使用してリソースを検索できます。たとえば、「system=AlloyDB AND type=Database」と入力すると、すべての AlloyDB データベースが表示されます。

詳細については、Dataplex Universal Catalog の検索構文をご覧ください。

ワークフローの例 - クラスタから列にドリルダウンする

クラスタから列にドリルダウンする手順は次のとおりです。

Dataplex Universal Catalog の [検索] ページに移動します。

[検索] に移動
[検索プラットフォームの選択] で、[Dataplex Universal Catalog] を選択します。
[フィルタ] パネルで、[システム]、[AlloyDB] の順に選択します。または、検索フィールドに「system=AlloyDB」と入力します。
クラスタ名を選択します。
[AlloyDB details] ページで、[エントリリスト] タブをクリックし、[検索結果の子エントリをすべて表示] をクリックします。Dataplex Universal Catalog にクラスタ内のデータベースが表示されます。

注: [エントリリスト] タブがない場合は、[検索] ページに戻って別のクラスタを選択します。
[AlloyDB database details] ページで、[エントリリスト] タブをクリックし、[子エントリを検索で表示する] をクリックします。Dataplex Universal Catalog にクラスタ内のテーブルが表示されます。
テーブル名を選択し、[AlloyDB table details] ページで [スキーマ] をクリックすると、テーブルの列が表示されます。
省略可: 列にアスペクトタイプを追加するには、[アスペクトを追加] ボタンをクリックします。

料金

Dataplex Universal Catalog に AlloyDB テクニカルメタデータを保存する場合、料金は発生しません。API 呼び出しと追加のビジネスメタデータの拡充には、Dataplex Universal Catalog の標準の料金が適用されます。詳細については、Dataplex Universal Catalog の料金ページをご覧ください。

リソースの使用量

Dataplex Universal Catalog は、クラスタから定期的にデータを抽出します。抽出プロセスには、一定の CPU 使用率が必要です。小さいマシンタイプ（大規模なスキーマ（10,000 個以上のテーブル）を共有するマシンなど）を含むクラスタの場合、抽出プロセス中に使用する CPU は少なくなります。

制限事項

データベースあたり最大 100 万個のテーブルを使用できます。
データベースの更新が Dataplex Universal Catalog に反映されるまでに、最大で 48 時間かかることがあります。
通常、抽出プロセスには数分かかりますが、完了までの時間は CPU サイズとテーブル数によって異なります。
インスタンスが存在しない場合や実行されていない場合、メタデータが削除されるまでに 7 日かかることがあります。

Dataplex Universal Catalog を使用して AlloyDB リソースを管理する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

メタデータ検出の種類

キーワード検索と自然言語検索

例: AlloyDB データベース スキーマの検出

アスペクトを使用してメタデータを拡充する

メタデータ検出ワークフロー

始める前に

必要な IAM のロール

検索結果へのアクセスに必要なロール

エントリの検索に必要なロール

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを有効にする

クラスタの作成時に Dataplex Universal Catalog インテグレーションを有効にする

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを有効にする

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを確認する

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

AlloyDB クラスタで Dataplex Universal Catalog インテグレーションを無効にする

curl（Linux、macOS、Cloud Shell）

PowerShell（Windows）

レスポンス

アスペクトを使用して AlloyDB アセットを拡充する

AlloyDB アセットを検索する

クエリを使用してキーワード検索を行う

アスペクト タイプで検索する

AlloyDB の自然言語検索

AlloyDB の構文検索

ワークフローの例 - クラスタから列にドリルダウンする

料金

リソースの使用量

制限事項

次のステップ

Dataplex Universal Catalog を使用して AlloyDB リソースを管理する

例: AlloyDB データベーススキーマの検出

アスペクトタイプで検索する