使用 Knowledge Catalog 管理 AlloyDB 資源

所有新的 AlloyDB 叢集預設都會啟用 Knowledge Catalog 整合功能，方便您使用 Knowledge Catalog 搜尋及管理 AlloyDB for PostgreSQL 資源。Knowledge Catalog 是一個可儲存、管理及存取中繼資料的平台。這項整合功能可協助您探索及瞭解 AlloyDB 中繼資料，支援下列用途：

分析：瞭解依附元件，並評估是否適合各種用途。
變更管理：有效追蹤及管理中繼資料變更。
漸進式結構定義更新：監控並規劃結構定義修改作業。

Knowledge Catalog 會自動從 AlloyDB 叢集、執行個體、資料庫、資料表、資料欄和檢視區塊擷取下列中繼資料：

名稱
位置 (區域)
標籤 (適用於叢集和執行個體)
已啟用 Dataplex 整合功能 (適用於叢集)
資料庫版本
機器 CPU 數量 (適用於執行個體)
可用性類型 (適用於執行個體)
字元集 (適用於資料庫)
排序規則 (適用於資料庫)
擁有者
說明 (適用於資料表、檢視區塊、資料欄和外部鍵)
類型 (適用於叢集、執行個體和機器)
欄
- 資料類型
- 模式
主鍵
外鍵
- 參照的表格
- 欄對應
建立時間
上次修改時間

中繼資料探索類型

知識目錄中繼資料探索功能會自動掃描已連結的資料來源 (例如 AlloyDB)，找出資料資產，例如資料表、檢視區塊和資料庫。接著，Knowledge Catalog 會從資產 (例如結構定義、說明和位置) 擷取技術中繼資料，並匯入 Knowledge Catalog。

這項程序會近乎即時地同步處理中繼資料，確保目錄與來源系統保持同步。對於 AlloyDB，系統預設會探索叢集和執行個體中繼資料。根據預設，新叢集會啟用資料庫、結構定義、資料表和檢視畫面中繼資料探索功能。如果是 2026 年 2 月 26 日前建立的叢集，請手動啟用整合功能。

關鍵字和自然語言搜尋

知識目錄支援關鍵字和自然語言搜尋。

關鍵字搜尋功能可讓您使用特定關鍵字、篩選條件和定義的語法尋找資源。舉例來說，如要查看所有 AlloyDB 資料庫，請輸入 system=AlloyDB AND type=Database。
自然語言搜尋 (搶先版) 會運用 AI 理解語意查詢，您可以使用日常用語尋找資源，不必再使用複雜的語法。例如，輸入 List all AlloyDB tables related to sales 等查詢。

詳情請參閱「Knowledge Catalog 的搜尋語法」。

範例：探索 AlloyDB 資料庫結構定義

如要瞭解中繼資料探索程序，請參考以下範例：啟用 Knowledge Catalog 整合功能的 AlloyDB 叢集 (名稱為 user-data-cluster)。這個叢集的主要執行個體內有名為 profiles 的資料庫，其中包含資料表 customers (id、email、signup_date) 和檢視區塊 active_users (id、email)。

由於 AlloyDB 會近乎即時地與知識型錄同步，因此您可以使用下列資源：

叢集
資料欄
資料庫
執行個體
資料表
瀏覽次數

探索完成後，請在 Google Cloud 控制台的「知識目錄」頁面中搜尋這些資產 (customers資料表和 active_users)，或使用 API 搜尋。然後查看架構，並使用其他業務或營運中繼資料加以擴充。

使用層面充實中繼資料

切面類型是可重複使用的資源，可做為切面的範本。切面類型有助於避免重複作業，以及建立不完整的切面。使用 Knowledge Catalog 建立必要的切面類型。

建立自訂切面類型後，請將切面附加至 AlloyDB 資產。將構面附加至 AlloyDB 資產，即可執行下列操作：

在資產中新增商家中繼資料。
依據業務中繼資料和其他自訂中繼資料搜尋資產。

如要進一步瞭解如何建立構面類型，以及將構面附加至 AlloyDB，請參閱「管理構面及豐富中繼資料」。

中繼資料探索工作流程

根據預設，系統會擷取叢集和執行個體資源，並提供探索功能。如要擷取及探索資料庫、結構定義、資料表和檢視資源，請按照下列步驟操作：

如果尚未啟用，請使用 AlloyDB API 為 AlloyDB 叢集啟用 Knowledge Catalog 整合功能。如果叢集是在 2026 年 2 月 26 日前建立，就必須執行這項操作。
在 Google Cloud 控制台的 Knowledge Catalog 搜尋頁面中，搜尋 AlloyDB 資產。詳情請參閱「在 Knowledge Catalog 中搜尋資源」。
如要為 AlloyDB 資產新增更多背景資訊，請將層面附加至資產。切面是自訂中繼資料項目，可協助進行資料治理和分析。舉例來說，您可以使用層面標記含有個人識別資訊 (PII) 的資料欄。詳情請參閱「管理層面及豐富中繼資料」。
按照以下階層瀏覽 AlloyDB 資源：叢集 > 資料庫 > 結構定義 > 資料表或檢視區塊 > 欄。這個階層可詳細呈現資料環境。詳情請參閱「在 Knowledge Catalog 中搜尋資源」。

事前準備

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

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
請檢查權限。

您必須具備特定的 Identity and Access Management (IAM) 角色和權限，才能搜尋 AlloyDB 資產並附加項目。詳情請參閱「知識目錄的必要 IAM 角色和權限」。

必要的 IAM 角色

本節說明搜尋資源及存取搜尋結果所需的角色和權限。

存取搜尋結果所需的角色

如要在知識目錄中搜尋及查看 AlloyDB 中繼資料，主體必須具備查看 AlloyDB 資源的權限，包括 dataplex.projects.search 權限。

如要將這些權限授予主體 (例如使用者、群組或服務帳戶)，請在包含 AlloyDB 資源的專案中，指派 AlloyDB 檢視者 (roles/alloydb.viewer) IAM 角色。

Knowledge 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 角色：

Dataplex Catalog 管理員 (roles/dataplex.catalogAdmin)
Dataplex Catalog 編輯者 (roles/dataplex.catalogEditor)
Dataplex Catalog 檢視者 (roles/dataplex.catalogViewer)

系統會檢查搜尋結果的權限，與所選專案無關。詳情請參閱「使用 Knowledge Catalog 搜尋資料資產」。

Knowledge Catalog 整合資料更新間隔

根據預設，知識目錄會擷取及探索叢集和執行個體資源，且中繼資料的即時性接近即時。

建立新的 AlloyDB 叢集時，系統預設會啟用資料庫、結構定義、資料表和檢視區塊資源的 Knowledge Catalog 整合功能。如要避免同步處理這類中繼資料，請停用整合功能。

啟用整合功能後，系統會將 AlloyDB 中繼資料 (例如資料庫、結構定義和資料表) 匯出至 Cloud Storage 儲存空間，以進行定期同步；或是匯出至 Pub/Sub 主題，以進行近乎即時的同步，並提供給 Knowledge Catalog 使用。這項功能僅適用於主要叢集。用於跨區域複製的次要叢集不支援資料庫、結構定義、資料表和檢視區塊中繼資料的 Knowledge Catalog 整合。

這些資源的中繼資料更新頻率取決於叢集的建立或還原時間：

近乎即時：在 2026 年 4 月 3 日當天或之後建立或還原的叢集，會近乎即時地將中繼資料同步至 Knowledge Catalog。更新最多可能需要 5 分鐘才會顯示在知識目錄中。擷取程序通常會在幾秒內完成。
每隔幾小時：在 2026 年 2 月 26 日至 2026 年 4 月 3 日之間建立或還原的叢集，每隔幾小時就會重新整理 Knowledge Catalog 中的中繼資料。更新內容最多會在 48 小時內顯示在知識目錄中。擷取程序通常需要幾分鐘，但完成時間取決於 CPU 大小和表格數量。

建立 AlloyDB，並停用 Knowledge Catalog 整合功能

使用 Google Cloud CLI 或 AlloyDB API 建立或更新叢集時，可以控管這項整合功能：

gcloud

使用 gcloud alloydb clusters create 指令建立 AlloyDB 叢集。如果省略 --enable-dataplex-integration 旗標，系統會預設啟用 Knowledge Catalog 整合功能，以取得資料庫、結構定義、資料表和檢視區塊中繼資料。如需這項呼叫的完整參數清單，請參閱 gcloud alloydb clusters create。如需叢集設定的相關資訊，請參閱「查看叢集和執行個體設定」。

請勿在叢集 ID 中加入敏感或個人識別資訊，因為叢集 ID 可能會顯示在各種作業環境中，例如系統記錄、監控資訊主頁和支援通訊。您不需要在叢集名稱中包含專案 ID，系統會在適當地方 (例如在記錄檔中) 自動加入。

如要停用資料庫、結構定義、資料表和檢視資源的 Knowledge Catalog 整合功能，請加入 --no-enable-dataplex-integration 旗標：

gcloud alloydb clusters create CLUSTER_ID \
    --password=PASSWORD \
    --region=REGION \
    --no-enable-dataplex-integration

請替換下列項目：

CLUSTER_ID：您建立的叢集 ID。叢集 ID 開頭須為小寫英文字母，且只能包含小寫英文字母、數字和連字號。
PASSWORD：您用於預設 postgres 使用者的密碼。
REGION：叢集所在區域的 ID。

REST

使用 POST 方法建立 AlloyDB 叢集。如果要求中省略 dataplexConfig，系統會預設啟用 Knowledge Catalog 整合功能，以處理資料庫、結構定義、資料表和檢視區塊中繼資料。如需這項呼叫的完整參數清單，請參閱「方法：projects.locations.clusters.create」。如需叢集設定的相關資訊，請參閱「查看叢集和執行個體設定」。

如要停用資料庫、結構定義、資料表和檢視資源的 Knowledge Catalog 整合功能，請在要求主體中加入 "dataplexConfig": { "enabled": false }：

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

請替換下列項目：

DATABASE_VERSION：資料庫版本的列舉字串，例如 POSTGRES_16。
INITIAL_USERNAME：您用於預設 postgres 使用者的使用者名稱。
INITIAL_USER_PASSWORD：您用於預設 postgres 使用者的密碼。

請使用下列 HTTP 方法和網址：

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 叢集啟用 Knowledge Catalog 整合功能

如要在現有叢集上啟用 Knowledge Catalog 整合功能，請使用下列其中一種程序：

gcloud

如要在現有叢集上啟用 Knowledge Catalog 整合功能，請使用 gcloud alloydb clusters update 指令並加上 --enable-dataplex-integration 標記。

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --enable-dataplex-integration

請替換下列項目：

CLUSTER_ID：叢集名稱。
REGION：叢集所在區域的 ID。

REST

如要更新現有叢集的特定欄位，請在 projects.locations.clusters resource 上使用 PATCH 方法。

請使用下列 HTTP 方法和網址：

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

請替換下列項目：

PROJECT_ID：包含叢集的 Google Cloud 專案 ID 或專案編號。
LOCATION_ID：叢集所在區域的 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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| 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 叢集上的 Knowledge Catalog 整合功能

如要確認現有叢集是否已啟用 Knowledge Catalog 整合功能，請使用下列其中一種程序：

gcloud

如要確認現有叢集是否已啟用 Knowledge Catalog 整合功能，請使用 gcloud alloydb clusters describe 指令。

gcloud alloydb clusters describe CLUSTER_ID --region=REGION

請替換下列項目：

CLUSTER_ID：叢集 ID。
REGION：叢集所在區域的 ID。

輸出內容會包含 YAML 格式的 dataplexConfig 區段。如果 enabled 為 true，表示已啟用 Knowledge Catalog 整合功能：

dataplexConfig:
  enabled: true

REST

如要確認現有叢集是否已啟用 Knowledge Catalog 整合功能，請使用 GET 方法。

請使用下列 HTTP 方法和網址：

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

請替換下列項目：

PROJECT_ID：包含叢集的 Google Cloud 專案 ID 或專案編號。
LOCATION_ID：叢集所在區域的 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/locations/LOCATION_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/locations/LOCATION_ID/clusters/CLUSTER_ID"| Select-Object -Expand Content

您會收到整個 Cluster Proto 的 JSON 回應，其中包含 dataplexConfig 訊息：

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

停用 AlloyDB 叢集上的 Knowledge Catalog 整合功能

在 AlloyDB 叢集上停用 Knowledge Catalog 整合功能後，就只能使用叢集和執行個體中繼資料。

gcloud

使用 gcloud alloydb clusters update 指令並加上 --no-enable-dataplex-integration 旗標，即可停用整合功能。

gcloud alloydb clusters update CLUSTER_ID \
    --region=REGION \
    --no-enable-dataplex-integration

請替換下列項目：

CLUSTER_ID：叢集 ID。
REGION：叢集所在區域的 ID。

REST

請參考下列範例停用整合功能。

請使用下列 HTTP 方法和網址：

PATCH https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled

請替換下列項目：

PROJECT_ID：包含叢集的 Google Cloud 專案 ID 或專案編號。
LOCATION_ID：叢集所在區域的 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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"

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/locations/LOCATION_ID/clusters/CLUSTER_ID?updateMask=dataplexConfig.enabled"| 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 資產

切面類型是可重複使用的資源，可做為切面的範本。切面類型有助於避免重複作業，以及建立不完整的切面。使用 Knowledge Catalog 建立必要的切面類型。

建立自訂切面類型後，請將切面附加至 AlloyDB 資產。將構面附加至 AlloyDB 資產可提供下列功能：

在資產中新增商家中繼資料
依業務中繼資料和其他自訂中繼資料搜尋資產

如要進一步瞭解如何建立構面類型，以及將構面附加至 AlloyDB，請參閱「管理構面及豐富中繼資料」。

搜尋 AlloyDB 資產

在 Google Cloud 控制台使用 Knowledge Catalog 搜尋頁面，搜尋 AlloyDB 資產。

前往 Knowledge Catalog 的「Search」(搜尋) 頁面。

前往「搜尋」頁面
在「選擇搜尋平台」中，選取「Knowledge Catalog」。
在「Filters」(篩選器) 面板中，按一下「Systems」(系統)，然後選取「AlloyDB」。
選用。在「Type aliases」(型別別名) 中，選取下列一或多個型別別名，將搜尋結果篩選為特定類型的 AlloyDB 資產：
- 資料庫
- 資料庫結構定義
- 叢集
- 執行個體
- 服務
- 資料表
- 查看
注意： Service 是 AlloyDB 執行個體的型別別名。

使用查詢執行關鍵字搜尋

在知識目錄中使用搜尋欄位執行關鍵字搜尋查詢。舉例來說，輸入 system=AlloyDB AND type=Database 即可查看所有 AlloyDB 資料庫。

詳情請參閱「Knowledge Catalog 的搜尋語法」。

如要查看所有 AlloyDB 資產，請輸入 system=AlloyDB。

然後輸入特定關鍵字。舉例來說，如要查看所有 AlloyDB 資料庫，請執行下列指令：

system=AlloyDB AND type=Database

如要查看所有 AlloyDB 資料表，請輸入下列查詢：

system=AlloyDB AND type=Table

您也可以使用括號和邏輯運算子 AND 和 OR，建立複雜的運算式。如要進一步瞭解搜尋欄位中可使用的運算式，請參閱「Knowledge 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"

依切面類型搜尋

知識目錄內建幾種層面類型，可協助您執行搜尋。

如要依面向類型搜尋，請按照下列步驟操作：

在「Aspects」(層面) 面板中，按一下「Add more aspect types」(新增更多層面類型) 選單。
選用。選取「AlloyDB Access」，即可依 AlloyDB 方言篩選結果。
選取下列一或多個切面類型，將搜尋結果限制為該類型。
- AlloyDB 資料庫
- AlloyDB 叢集
- AlloyDB 執行個體
- AlloyDB 檢視畫面
- AlloyDB 結構定義
- AlloyDB 資料表
按一下 [確定]。
在結果表格中，按一下資產名稱，即可查看該資產的中繼資料。
選用：強化或查看素材資源。您可以透過下列方式強化或查看素材資源：
- 如要新增資產的 RTF 格式說明，請按一下「總覽」中的「新增」。
- 如要將切面附加至資產，請按一下「切面」中的「新增」。
- 如要查看執行個體的成員資料庫，請按一下「項目清單」分頁，然後點選「在搜尋中顯示所有子項目」。如果沒有顯示「項目清單」分頁，表示叢集沒有資料庫。
- 在「項目詳細資料」中查看素材資源的完整詳細資料。按一下項目名稱，即可向下鑽研其他項目。

AlloyDB 的自然語言搜尋功能

自然語言搜尋 (搶先版) 會運用 AI 理解語意查詢，您可以使用日常用語尋找資源，不必再使用複雜的語法。例如，輸入 List all AlloyDB tables related to sales 等查詢。

詳情請參閱「Knowledge Catalog 的搜尋語法」。

在 AlloyDB 中搜尋語法

關鍵字搜尋功能可讓您使用特定關鍵字、篩選條件和定義的語法尋找資源。舉例來說，輸入 system=AlloyDB AND type=Database 即可查看所有 AlloyDB 資料庫。

詳情請參閱「Knowledge Catalog 的搜尋語法」。

工作流程範例 - 從叢集向下鑽研至資料欄

如要從叢集向下鑽研至資料欄，請按照下列步驟操作：

前往 Knowledge Catalog 的「Search」(搜尋) 頁面。

前往「搜尋」頁面
在「選擇搜尋平台」選項中，選取「Knowledge Catalog」。
在「篩選器」面板中，依序選取「系統」和「AlloyDB」。或者，在搜尋欄位中輸入 system=AlloyDB。
選取叢集名稱。
在「AlloyDB 詳細資料」頁面中，按一下「項目清單」分頁標籤，然後點選「在搜尋中顯示所有子項目」。知識目錄會顯示叢集中的資料庫。

注意： 如果沒有顯示「項目清單」分頁，請返回「搜尋」頁面，然後選擇其他叢集。
在「AlloyDB database details」(AlloyDB 資料庫詳細資料) 頁面中，按一下「Entry list」(項目清單) 分頁標籤，然後按一下「View child entries in search」(在搜尋結果中查看子項目)。知識目錄會顯示叢集中的資料表。
選取資料表名稱，然後在「AlloyDB table details」(AlloyDB 資料表詳細資料) 頁面上，按一下「結構定義」即可查看資料表欄。
選用：如要為欄新增層面類型，請按一下「新增層面」按鈕。

定價

在 Knowledge Catalog 中儲存 AlloyDB 技術中繼資料不會產生費用。 API 呼叫和額外商業中繼資料擴充功能適用標準 Knowledge Catalog 定價。詳情請參閱 Knowledge Catalog 定價頁面。

資源使用情況

Knowledge Catalog 會定期從 AlloyDB 叢集擷取中繼資料。這項擷取程序會耗用叢集中的 CPU 資源。CPU 使用率通常很低。舉例來說，如果叢集使用較小的機器類型 (例如 n2-highmem-2-icelake) 管理大型結構定義 (例如含有 10 萬個以上的表格)，在擷取期間 CPU 使用率可能會增加最多 5%。

限制

這項整合功能每個資料庫最多支援一百萬個資料表，每個資料表平均支援 150 個資料欄。如果超過任一限制，系統就不會擷取資料庫、結構定義、資料表和檢視表等資源的中繼資料。Knowledge Catalog 僅提供叢集和執行個體中繼資料。
首次建立叢集時，將所有中繼資料同步至知識目錄最多可能需要 48 小時。完成首次同步後，後續更新會近乎即時提供。
如果資料庫的後設資料變更率偏高 (每秒超過 100 項 DDL 變更)，與 Knowledge Catalog 的近乎即時後設資料同步作業可能會暫停最多 30 分鐘，然後再繼續。
如果因中繼資料變更頻率過高、網路問題或同步處理程序中斷而錯過任何更新，這些更新最終會在 48 小時內顯示在知識目錄中。
如果執行個體不存在或未執行，中繼資料可能需要 7 天才能刪除。
資料庫重新命名後，只有資料庫更新會近乎即時地顯示在知識目錄中。資料庫和所有相關資料表的基礎對應項目，會在 48 小時內更新至知識目錄。

使用 Knowledge Catalog 管理 AlloyDB 資源 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

中繼資料探索類型

關鍵字和自然語言搜尋

範例：探索 AlloyDB 資料庫結構定義

使用層面充實中繼資料

中繼資料探索工作流程

事前準備

必要的 IAM 角色

存取搜尋結果所需的角色

搜尋記錄所需的角色

Knowledge Catalog 整合資料更新間隔

建立 AlloyDB，並停用 Knowledge Catalog 整合功能

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

為 AlloyDB 叢集啟用 Knowledge Catalog 整合功能

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

驗證 AlloyDB 叢集上的 Knowledge Catalog 整合功能

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

停用 AlloyDB 叢集上的 Knowledge Catalog 整合功能

gcloud

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

回應

使用切面擴充 AlloyDB 資產

搜尋 AlloyDB 資產

使用查詢執行關鍵字搜尋

依切面類型搜尋

AlloyDB 的自然語言搜尋功能

在 AlloyDB 中搜尋語法

工作流程範例 - 從叢集向下鑽研至資料欄

定價

資源使用情況

限制

後續步驟

使用 Knowledge Catalog 管理 AlloyDB 資源