Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

使用 Knowledge Catalog 管理 AlloyDB 資源

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

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

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

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

詳情請參閱「關於 Knowledge Catalog 的中繼資料管理功能」。

中繼資料探索類型

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

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

關鍵字和自然語言搜尋

Knowledge Catalog 支援關鍵字和自然語言搜尋。

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

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

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

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

AlloyDB 會近乎即時地同步至 Knowledge Catalog，因此可使用下列資源：

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

探索完成後，請在 Google Cloud 控制台的 Knowledge Catalog 頁面中，或使用 API 搜尋這些資產：customers資料表和active_users。接著查看結構定義，並加入其他業務或作業中繼資料，讓資料更豐富。

使用切面充實中繼資料

切面類型是可重複使用的資源，可做為切面的範本。切面類型有助於避免重複作業，以及建立不完整的切面。使用 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 中搜尋資源」。

事前準備

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.
Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector
Verify that billing is enabled for your Google Cloud project.
為專案啟用 Dataplex API。

啟用 Dataplex API
請檢查權限。

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

必要的 IAM 角色

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

存取搜尋結果所需的角色

如要在 Knowledge Catalog 搜尋及查看 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`
	Tables	`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 整合功能資料更新間隔

根據預設，Knowledge Catalog 會擷取及探索叢集和執行個體資源，且中繼資料會近乎即時更新。

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

啟用整合功能後，AlloyDB 中繼資料 (例如資料庫、結構定義和資料表) 就會匯出至 Cloud Storage bucket (定期同步) 或 Pub/Sub 主題 (近乎即時同步)，並提供給 Knowledge Catalog。這項功能僅適用於主要叢集。用於跨區域複製的次要叢集不支援整合 Knowledge Catalog，無法用於資料庫、結構定義、資料表和檢視表中繼資料。

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

近乎即時：2026 年 4 月 3 日當天或之後建立或還原的叢集，會近乎即時地將中繼資料同步至 Knowledge Catalog。更新內容最多會在 5 分鐘內顯示於 Knowledge Catalog。擷取程序通常會在幾秒內完成。
每幾小時：2026 年 2 月 26 日至 2026 年 4 月 3 日期間建立或還原的叢集，每幾小時就會在 Knowledge Catalog 中重新整理中繼資料。更新內容最多會在 48 小時後顯示於 Knowledge Catalog。擷取程序通常會在幾分鐘內完成，但實際時間取決於 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 回覆：

回應

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

為 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 回覆：

回應

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-09-25T22:19:33.735Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

確認 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

您會收到整個叢集 proto 的 JSON 回應，其中包含 dataplexConfig 訊息：

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

注意：如果叢集已停用 Knowledge Catalog 整合功能，API 會傳回 "dataplexConfig": {}，因為 proto3 會省略具有預設值的欄位。

停用 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 回覆：

回應

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
    "createTime": "2024-01-16T02:32:12.281Z",
    "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
    "verb": "update",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

使用切面充實 AlloyDB 資產

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

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

將業務中繼資料新增至資產
依業務中繼資料和其他自訂中繼資料搜尋資產

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

搜尋 AlloyDB 資產

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

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

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

使用查詢執行關鍵字搜尋

在 Knowledge Catalog 的搜尋欄位中，執行關鍵字搜尋查詢。例如，輸入 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/dataplex-types/locations/global/entryTypes/alloydb-cluster"

依切面類型搜尋

Knowledge Catalog 內建幾種切面類型，可協助您執行搜尋。

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

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

AlloyDB 的自然語言搜尋

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

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

在 AlloyDB 執行語法搜尋

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

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

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

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

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

前往「Search」(搜尋) 頁面
在「選擇搜尋平台」選項中，選取「Knowledge Catalog」。
在「篩選器」面板中，依序選取「系統」和「AlloyDB」。或是在搜尋欄位中輸入 system=AlloyDB。
選取叢集名稱。
在「AlloyDB details」(AlloyDB 詳細資料) 頁面中，按一下「Entry list」(項目清單) 分頁標籤，然後點選「Show all children entries in search」(在搜尋中顯示所有子項目)。Knowledge Catalog 會顯示叢集中的資料庫。

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

定價

在 Knowledge Catalog 儲存 AlloyDB 技術中繼資料無須付費。API 呼叫和額外的業務中繼資料擴充，適用標準 Knowledge Catalog 定價。詳情請參閱 Knowledge Catalog 定價頁面。

資源使用情況

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

限制

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

使用 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 資源