使用 Dataplex Universal Catalog 管理 AlloyDB 資源

預先發布版

這項功能 適用《服務專屬條款》。 正式發布前的功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

您可以使用 Dataplex Universal Catalog 搜尋及管理 AlloyDB for PostgreSQL 資源。這個平台可儲存、管理及存取中繼資料。您可以使用 Dataplex Universal Catalog 探索及瞭解 AlloyDB 中繼資料。使用 Dataplex Universal Catalog 執行下列操作：

• 分析，包括依附元件和是否適合用途
• 變更管理
• 結構定義演變

Dataplex Universal Catalog 會自動從 AlloyDB 擷取下列中繼資料：

資源類型	已擷取中繼資料
叢集、資料庫和執行個體	名稱 位置 (區域)
結構定義、資料欄、資料表、檢視區塊	名稱 位置 (區域) 說明 結構定義

注意： Dataplex Universal Catalog 會將 AlloyDB 和其他 Google Cloud 服務中的資源稱為「資產」。在本文件中，我們將 AlloyDB 資源 (執行個體、資料庫、資料表和檢視區塊) 稱為 AlloyDB 資產。我們也會使用「資產」一詞，同時指稱資源和這些資源的 Dataplex Universal Catalog 中繼資料。

中繼資料探索類型

就 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 整合功能的 AlloyDB 叢集 (名稱為 user-data-cluster)。在這個叢集的主要執行個體中，您有一個名為 profiles 的資料庫，其中包含資料表 customers (id、email、signup_date) 和檢視區塊 active_users (id、email)。

AlloyDB 會定期與 Dataplex Universal Catalog 同步，因此您可以使用下列資源：

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

探索完成後，您可以在 Google Cloud 控制台的 Dataplex Universal Catalog 頁面中搜尋這些資產 (customers資料表和 active_users)，也可以使用 API 搜尋，並查看這些資產的結構定義，以及使用其他業務或作業中繼資料來擴充這些資產。

使用層面充實中繼資料

切面類型是可重複使用的資源，可用做切面的範本。切面類型可協助您避免重複作業和不完整的切面。您可以使用 Dataplex Universal Catalog 建立所需的切面類型。

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

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

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

中繼資料探索工作流程

根據預設，系統會擷取叢集和執行個體資源，並提供探索功能。如要擷取及探索資料庫、結構定義、資料表和檢視畫面資源，才需要為 AlloyDB 叢集啟用 Dataplex Universal Catalog 整合功能。

1. 如要探索 AlloyDB 資料庫、結構定義、資料表和檢視資源，您必須在建立新叢集或更新現有叢集時，使用 AlloyDB API 為 AlloyDB 叢集啟用 Dataplex Universal Catalog 整合功能。詳情請參閱「建立叢集及其主要執行個體」。

2. 在 Google Cloud 控制台，使用 Dataplex Universal Catalog 搜尋頁面搜尋 AlloyDB 資產。詳情請參閱「在 Dataplex Universal Catalog 中搜尋資源」。

3. 如要為 AlloyDB 資產新增更多背景資訊，可以將層面附加至資產。切面是自訂中繼資料項目，可協助進行資料治理和分析。舉例來說，您可以使用層面標記含有個人識別資訊 (PII) 的資料欄。詳情請參閱「管理層面及豐富中繼資料」。

4. 您現在可以按照以下階層瀏覽 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.

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.

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.

1. 為專案啟用 Dataplex API。

   啟用 Dataplex API

2. 請檢查權限。

   您需要特定 Identity and Access Management (IAM) 角色和權限，才能搜尋 AlloyDB 資產並附加項目。詳情請參閱「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

注意： 如果您在專案層級授予 roles/alloydb.viewer 角色，擁有這個角色的主體就能查看專案中所有 AlloyDB 執行個體的中繼資料。

如果不想使用預先定義的「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)

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

在 AlloyDB 叢集上啟用 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 方法和下列網址。如需這項呼叫的完整參數清單，請參閱「方法：projects.locations.clusters.create」。如要瞭解叢集設定，請參閱「查看叢集和執行個體設定」。

請勿在叢集 ID 中加入敏感資訊或個人識別資訊，因為外部使用者可以看見此 ID。您不需要在叢集名稱中包含專案 ID，系統會在適當地方 (例如在記錄檔中) 自動加入。

注意： 只有 Terraform 和 REST API 支援為 AlloyDB 資源新增標籤。您無法使用 Google Cloud 控制台或 Google Cloud CLI 管理標籤。

如要傳送要求，請將要求主體儲存在名為 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 方法和網址：

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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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": "[e-mail]",
  "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 方法和網址：

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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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": "[e-mail]",
  "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 方法和網址：

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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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

您會收到整個叢集 Proto 的 JSON 回應。在 proto 中尋找 dataplexConfig 訊息：

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

停用 AlloyDB 叢集與 Dataplex Universal Catalog 的整合

請使用下列範例停用整合功能。停用這項功能後，就只能使用叢集和執行個體中繼資料。

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

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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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)

下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 Google Cloud CLI，或是使用 Cloud Shell，系統會自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 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": "[e-mail]",
  "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 資產

切面類型是可重複使用的資源，可用做切面的範本。切面類型可協助您避免重複作業和切面不完整的問題。您可以使用 Dataplex Universal Catalog 建立所需的切面類型。

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

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

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

搜尋 AlloyDB 資產

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

1. 前往 Dataplex Universal Catalog 的「Search」(搜尋) 頁面。

   前往「搜尋」頁面

2. 在「選擇搜尋平台」中，選取「Dataplex Universal Catalog」。

3. 在「Filters」(篩選器) 面板中，按一下「Systems」(系統)，然後選取「AlloyDB」。

4. (選用步驟) 在「型別別名」中，選取一或多個下列型別別名，即可將搜尋結果篩選為特定類型的 AlloyDB 資產：

   • 資料庫
   • 資料庫結構定義
   • 叢集
   • 執行個體
   • 服務
   • 資料表
   • 查看
   注意： Service 是 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 內建幾種切面類型，可用於執行搜尋。

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

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

AlloyDB 的自然語言搜尋功能

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

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

在 AlloyDB 中搜尋語法

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

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

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

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

1. 前往 Dataplex Universal Catalog 的「Search」(搜尋) 頁面。

   前往「搜尋」頁面

2. 在「選擇搜尋平台」選項中，選取「Dataplex Universal Catalog」。

3. 在「篩選器」面板中，依序選取「系統」和「AlloyDB」。或者，在搜尋欄位中輸入 system=AlloyDB。

4. 選取叢集名稱。

5. 在「AlloyDB details」(AlloyDB 詳細資料) 頁面中，按一下「Entry list」(項目清單) 分頁標籤，然後點選「Show all children entries in search」(在搜尋中顯示所有子項目)。Dataplex Universal Catalog 會顯示叢集中的資料庫。

   注意： 如果沒有「項目清單」分頁，請返回「搜尋」頁面，然後選擇其他叢集。

6. 在「AlloyDB database details」(AlloyDB 資料庫詳細資料) 頁面中，按一下「Entry list」(項目清單) 分頁標籤，然後按一下「View child entries in search」(在搜尋結果中查看子項目)。Dataplex Universal Catalog 會顯示叢集中的資料表。

7. 選取資料表名稱，然後在「AlloyDB table details」(AlloyDB 資料表詳細資料) 頁面上，按一下「Schema」(結構定義) 即可查看資料表欄。

8. 選用：如要為欄新增層面類型，請按一下「新增層面」按鈕。

定價

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

資源使用情況

Dataplex Universal Catalog 會定期從叢集擷取資料。擷取程序需要一定的 CPU 用量。如果叢集使用較小的機器類型 (例如共用較大結構定義的機器，也就是 10,000 個以上的表格)，則在擷取程序期間可能會使用少量 CPU。

限制

• 每個資料庫最多可有 100 萬個資料表。
• 資料庫更新最多需要 48 小時，才會反映在 Dataplex Universal Catalog 中。
• 擷取程序通常需要幾分鐘，但完成時間取決於 CPU 大小和表格數量。
• 如果執行個體不存在或未執行，中繼資料可能需要 7 天才能刪除。

後續步驟

• 關於 Dataplex Universal Catalog 中的資料目錄管理
• Dataplex Universal Catalog Identity and Access Management 角色