使用 Knowledge Catalog 管理 Cloud SQL 資源

本頁面說明如何使用 Knowledge Catalog (舊稱 Dataplex Universal Catalog) 搜尋及管理 Cloud SQL 資源。

Knowledge Catalog 是用於儲存、管理及存取中繼資料的平台。Knowledge Catalog 會自動從 Cloud SQL 執行個體、資料庫、資料表、資料欄和檢視表擷取下列中繼資料：

  • 名稱
  • 位置 (區域)
  • 建立日期和上次修改日期
  • 結構定義 (適用於資料表和檢視表)
  • 說明
  • 主鍵和外鍵限制

Knowledge Catalog 只會從 Cloud SQL 主要執行個體擷取中繼資料，不會從唯讀副本或外部伺服器副本擷取。

您可以使用 Knowledge Catalog 探索及瞭解 Cloud SQL 中繼資料。使用 Knowledge Catalog 協助執行下列活動：

  • 資料探索
  • 分類
  • 分析，包括依附元件和用途適用性
  • 變更管理
  • 資料移動 (管道)
  • 漸進式結構定義更新

您可以使用 Knowledge Catalog，將面向附加至 Cloud SQL 中繼資料項目，藉此管理中繼資料。每個切面可以有多個中繼資料欄位，並可根據預先定義或自訂的切面類型。

舉例來說，您可以將下列切面附加至包含身分證字號 (個人識別資訊，PII) 的資料欄：

  pii:true
  pii_type:SSN

如要進一步瞭解 Knowledge Catalog，請參閱「關於 Knowledge Catalog 的中繼資料管理功能」。

Knowledge Catalog 整合功能資料更新間隔

Knowledge Catalog 中執行個體中繼資料的預期更新時間，取決於執行個體的建立日期、資料庫版本和網路架構。

近乎即時

如果執行個體符合下列所有條件，則建立執行個體時，預設會啟用與 Knowledge Catalog 的整合功能：

  1. 建立時間：2026 年 11 月 9 日當天或之後

  2. 版本：所有 SQL Server 版本
  3. 網路架構：新網路架構

如果現有執行個體是在 2026 年 4 月 18 日前建立，且符合版本和新網路架構條件，則可按照「在現有 Cloud SQL 執行個體啟用 Knowledge Catalog 整合功能」一節的操作說明，啟用 Knowledge Catalog 整合功能，系統會近乎即時地啟用整合功能。如果這類執行個體已啟用 Knowledge Catalog 整合功能，且同步頻率為每天一次，您可以停用整合功能，然後重新啟用，將同步頻率從每天一次改為近乎即時。

如果執行個體不符合近乎即時整合的條件，請參閱「每天一次」。

近乎即時整合的執行個體包含時間戳記資料表，可追蹤資產的建立和更新時間。時間戳記資料表是 gcloud_cloudsqladmin 資料庫中的 resource_timestamps 資料表。您可以在 Google Cloud 控制台的 Cloud SQL 中查詢時間戳記資料表。當執行個體有 DDL 或結構定義變更時，整合功能會查詢時間戳記資料表，找出最近變更的資產，然後近乎即時地將最新的結構定義更新載入 Knowledge Catalog。在極少數情況下 (例如網路不穩定)，Knowledge Catalog 可能會遺漏更新。雖然這種情況很少見，但任何遺漏的變更最終都會保持一致，通常會在 24 小時內完成。如要進一步瞭解可能導致遺漏變更的情境，請參閱本頁的「限制」一節。

查看在執行個體中執行的查詢時，您會看到支援 Knowledge Catalog 整合功能的查詢。您可以透過查詢包含的 --Dataplex 註解來識別這些查詢。如要查看執行個體的查詢，請參閱「查看執行中的查詢」。

您可以停用整合功能，並按照「更新執行個體」中的操作說明，稍後重新啟用。

一天一次

如果執行個體符合下列任一條件，即可啟用與 Knowledge Catalog 整合的功能：

  1. 建立時間：2026 年 4 月 18 日前
  2. 版本：所有 SQL Server 版本
  3. 網路架構：舊網路架構

啟用與 Knowledge Catalog 的整合功能後，符合上述任一條件的執行個體中繼資料，通常會每天在 Knowledge Catalog 中重新整理一次。

如果執行個體是在 2026 年 3 月 24 日後建立，系統預設會啟用 Knowledge Catalog 整合功能。如果是 2026 年 4 月 18 日前建立的執行個體，您可以在現有 Cloud SQL 執行個體上啟用 Knowledge Catalog 整合功能。

如果 2026 年 4 月 18 日前建立的現有執行個體符合近乎即時的版本和新網路架構條件，則啟用 Knowledge Catalog 整合功能 (或停用整合功能，並在已整合的情況下重新啟用，每天一次)，即可將執行個體設為近乎即時更新。

您可以停用整合功能，並按照「更新執行個體」中的操作說明，稍後重新啟用。

事前準備

  1. 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

  2. Verify that billing is enabled for your Google Cloud project.

  3. 為專案啟用 Dataplex API。

    啟用 Dataplex API

  4. 請檢查權限。

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

Knowledge Catalog 的必要 IAM 角色和權限

Cloud SQL 會使用 cloudsql.schemas.view 權限，提供 Knowledge Catalog 中繼資料的存取權。

如要提供這項權限，請建立包含這項權限的自訂角色，或使用具備這項權限的預先定義角色。

詳情請參閱「預先定義的 Cloud SQL IAM 角色」。

建立已啟用 Knowledge Catalog 整合功能的執行個體

新執行個體預設會與 Knowledge Catalog 整合。如要建立已啟用 Knowledge Catalog 整合功能的新執行個體，只要建立新執行個體即可。如要建立近乎即時整合 Knowledge Catalog 的執行個體，新執行個體必須符合下列所有條件：

  1. 建立時間：2026 年 11 月 9 日當天或之後

  2. 版本：所有 SQL Server 版本
  3. 網路架構：新網路架構

如要為資料庫版本較舊或網路架構較舊的新執行個體啟用近乎即時的 Knowledge Catalog，可以複製執行個體，或從備份還原至新的執行個體。

gcloud

建立執行個體

如要建立 Cloud SQL 執行個體，請使用 gcloud sql instances create 指令。

gcloud sql instances create INSTANCE_NAME \
  --database-version=DATABASE_VERSION \
  --tier=MACHINE_TYPE \
  --region=REGION_NAME

請依指示取代下列項目：

  • INSTANCE_NAME：執行個體的名稱
  • DATABASE_VERSION：執行個體的資料庫版本 (例如 SQLSERVER_2019_ENTERPRISE)。如需可用字串的完整清單，請參閱 SqlDatabaseVersion
  • MACHINE_TYPE：執行個體的機型
  • REGION_NAME：執行個體的區域名稱

本範例以 Linux 為基礎。

REST v1

建立執行個體

使用這個範例建立已啟用整合功能的執行個體。如需這項呼叫可用的完整參數清單，請參閱 instances.insert 頁面。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含執行個體
  • INSTANCE_NAME：執行個體的名稱
  • REGION_NAME：執行個體的區域名稱
  • DATABASE_VERSION：資料庫版本的列舉字串 (例如 POSTGRES_13)。如需可用字串的完整清單，請參閱 SqlDatabaseVersion。
  • PASSWORD：root 使用者的密碼
  • MACHINE_TYPE：機器 (層級) 類型的列舉字串，例如：db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE：Cloud SQL 版本

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

JSON 要求主體：

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

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

REST v1beta4

建立執行個體

使用這個範例建立已啟用整合功能的執行個體。如需這項呼叫可用的完整參數清單，請參閱 instances.insert 頁面。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID： Google Cloud 專案的 ID 或專案編號，該專案包含執行個體
  • INSTANCE_NAME：執行個體的名稱
  • REGION_NAME：執行個體的區域名稱
  • DATABASE_VERSION：資料庫版本的列舉字串 (例如 POSTGRES_13)。如需可用字串的完整清單，請參閱 SqlDatabaseVersion。
  • PASSWORD：root 使用者的密碼
  • MACHINE_TYPE：機器 (層級) 類型的列舉字串，例如：db-custom-[CPUS]-[MEMORY_MBS]
  • EDITION_TYPE：Cloud SQL 版本

HTTP 方法和網址：

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

JSON 要求主體：

{
  "name": "INSTANCE_NAME",
  "region": "REGION_NAME",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "enableDataplexIntegration": true
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

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

在現有 Cloud SQL 執行個體上啟用 Knowledge Catalog 整合功能

您可以按照本節的更新操作說明，在 2026 年 4 月 18 日前建立的現有執行個體上啟用 Knowledge Catalog 整合功能。

在現有執行個體啟用 Knowledge Catalog 整合功能時：

  • 如果執行個體符合下列任一條件，啟用 Knowledge Catalog 整合功能後，系統會每天更新一次：

  • 如果執行個體符合下列所有條件，啟用 Knowledge Catalog 整合功能後，系統就會近乎即時地更新：

    啟用近乎即時的整合功能後，新的 DDL 和結構定義變更會在 10 分鐘內顯示，而執行個體上的現有資源則會在 24 小時內填入。

如要啟用或重新啟用現有 Cloud SQL 執行個體的 Knowledge Catalog 整合功能，請採用下列其中一項程序。

gcloud

更新執行個體

如要為現有執行個體啟用整合功能，請使用 gcloud sql instances patch 指令。

gcloud sql instances patch INSTANCE_NAME \
  --enable-dataplex-integration

如要啟用及更新專案中的所有 Cloud SQL 執行個體，可以執行類似下列的指令碼：

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --enable-dataplex-integration

本範例以 Linux 為基礎。

REST v1

更新執行個體

請參考這個範例，更新現有執行個體。如需這項呼叫可用的完整參數清單，請參閱 instances.patch 頁面。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號
  • INSTANCE_NAME：執行個體的名稱

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

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

REST v1beta4

更新執行個體

使用這個範例更新現有執行個體。如需這項呼叫可用的完整參數清單，請參閱 instances.patch 頁面。

請參考這個範例，更新現有執行個體。如需這項呼叫可用的完整參數清單，請參閱 instances.patch 頁面。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號
  • INSTANCE_NAME：執行個體的名稱

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

{
  "settings":
  {
    "enableDataplexIntegration": true
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

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

驗證 Cloud SQL 執行個體的 Knowledge Catalog 整合功能

如要確認執行個體是否已啟用 Knowledge Catalog 整合功能，請採用下列其中一項程序。

gcloud

如要確認現有執行個體是否已啟用 Knowledge Catalog 整合功能，請使用 gcloud sql instances describe 指令。

gcloud sql instances describe INSTANCE_NAME

將 INSTANCE_NAME 替換為執行個體名稱。在輸出內容中，找出設為 true 的設定 enableDataplexIntegration。

REST v1

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

REST v1beta4

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：專案 ID
  • INSTANCE_ID：執行個體 ID

HTTP 方法和網址：

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

{
"settings":
  {
  "enableDataplexIntegration": true
  }
}

停用 Cloud SQL 執行個體的 Knowledge Catalog 整合功能

如要停用 Cloud SQL 執行個體的 Knowledge Catalog 整合功能，請採用下列其中一項程序。

如果執行個體已整合，停用 Knowledge Catalog 整合功能最多需要 10 分鐘。

控制台

  1. 前往 Google Cloud 控制台的「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面。

    前往「Cloud SQL Instances」(Cloud SQL 執行個體) 頁面

  2. 點選執行個體名稱，開啟執行個體的「總覽」頁面。
  3. 按一下 [編輯]。
  4. 在「Customize your instance」(自訂執行個體) 區段中，展開「Show configuration options」(顯示設定選項) 選單。

  5. 在「Flags and parameters」(旗標與參數) 部分，取消勾選「Enable Knowledge Catalog integration」(啟用 Knowledge Catalog 整合功能) 核取方塊。

  6. 按一下「儲存」。

gcloud

如要停用現有執行個體的整合功能，請使用 gcloud sql instances patch 指令。

gcloud sql instances patch INSTANCE_NAME \
  --no-enable-dataplex-integration

如要停用整合功能，並更新專案中的所有 Cloud SQL 執行個體，可以執行類似下列的指令碼：

gcloud sql instances list --format="(NAME)" \
| tail -n +2 | xargs -t -I %
gcloud sql instances patch % --no-enable-dataplex-integration

本範例以 Linux 為基礎。

REST v1

使用這個範例停用整合。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號
  • INSTANCE_NAME：執行個體的名稱

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

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

REST v1beta4

使用這個範例停用整合。

使用任何要求資料之前，請先修改下列項目的值：

  • PROJECT_ID：包含執行個體的 Google Cloud 專案 ID 或專案編號
  • INSTANCE_NAME：執行個體的名稱

HTTP 方法和網址：

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

JSON 要求主體：

{
  "settings":
  {
    "enableDataplexIntegration": false
  }
}

請展開以下其中一個選項，以傳送要求：

您應該會收到如下的 JSON 回覆：

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

使用切面充實 Cloud SQL 資產

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

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

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

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

搜尋 Cloud SQL 資產

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

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

    前往「Search」(搜尋) 頁面

  2. 在「選擇搜尋平台」部分，選取「Knowledge Catalog」。

  3. 在「篩選器」面板中，依序點選「系統」和「Cloud SQL」。

  4. 選用。在「Type aliases」(類型別名) 中，您可以選取下列一或多個類型別名，將搜尋結果篩選為特定類型的 Cloud SQL 資產：

    • 資料庫
    • 資料庫結構定義
    • 服務
    • 資料表
    • 查看

使用查詢執行搜尋

您也可以使用 Knowledge Catalog 的搜尋欄位執行搜尋查詢。如要查看所有 Cloud SQL 資產，請輸入 system=Cloud_SQL。

接著輸入特定關鍵字。例如，如要查看所有 Cloud SQL 資料庫，請執行下列指令：

system=Cloud_SQL AND type=Database

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

system=Cloud_SQL AND type=Table

您也可以使用括號和邏輯運算子 AND 和 OR 來表示複雜的運算式。如要進一步瞭解可在搜尋欄位中使用的運算式，請參閱「Knowledge Catalog 的搜尋語法」。

您可以直接在搜尋欄位中輸入特定 Cloud SQL 資產的搜尋查詢。查詢字串的格式如下：

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

將 QUERY_STRING 替換為查詢字串，具體取決於 Cloud SQL 引擎和要查詢的資產類型。請參閱下表，找出適當的查詢字串。

Cloud SQL 引擎 查詢字串
MySQL 適用的 Cloud SQL
  • cloudsql-mysql-database
  • cloudsql-mysql-instance
  • cloudsql-mysql-table
  • cloudsql-mysql-view
PostgreSQL 適用的 Cloud SQL
  • cloudsql-postgresql-database
  • cloudsql-postgresql-instance
  • cloudsql-postgresql-table
  • cloudsql-postgresql-schema
  • cloudsql-postgresql-view
SQL Server 適用的 Cloud SQL
  • cloudsql-sqlserver-database
  • cloudsql-sqlserver-instance
  • cloudsql-sqlserver-table
  • cloudsql-sqlserver-schema
  • cloudsql-sqlserver-view

查詢範例如下：

type="projects/dataplex-types/locations/global/entryTypes/cloudsql-postgresql-instance"

依 Cloud SQL 方言篩選 Cloud SQL 資產

根據預設，Knowledge Catalog 會顯示所有 Cloud SQL 資產。如要篩選資產，只顯示 MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 或 SQL Server，請按照下列步驟操作。

  1. 在「Aspects」(切面) 面板中，按一下「Add more aspect types」(新增更多切面類型) 選單。

  2. 選取「SQL Access」。

  3. 按一下 [確定]。

  4. 按一下 playlist_add 「編輯切面」按鈕。在「SQL Access」(SQL 存取權) 頁面中，執行下列操作：

    • 在「Dialect」(方言) 欄位中，選取「SQL Server」，篩選出 SQL Server 資產。
  5. 選用。選取「Version」(版本) 欄位，然後輸入特定版本的 SQL Server。

  6. 按一下 [套用]。Knowledge Catalog 只會顯示 SQL Server 資產。

Knowledge Catalog 內建幾種切面類型，可用於執行搜尋。

  1. 在「Aspects」(切面) 面板中，按一下「Add more aspect types」(新增更多切面類型) 選單。

  2. 選用。選取「SQL Access」(SQL 存取權)，依 Cloud SQL 方言篩選結果。詳情請參閱前述程序「依 Cloud SQL 方言篩選 Cloud SQL 資產」。

  3. 選取下列一或多個切面類型，將搜尋結果限制為該類型。

    • Cloud SQL 資料庫
    • Cloud SQL 執行個體
    • Cloud SQL 檢視畫面
    • Cloud SQL 結構定義
    • Cloud SQL 資料表

  4. 按一下 [確定]。

  5. 在結果表格中，按一下資產名稱，即可查看該資產的中繼資料。

  6. 選用：強化或查看素材資源。您可以執行下列任一操作：

    • 在「Overview」(總覽) 中，按一下「Add」(新增)，新增資產的 RTF 格式說明。
    • 在「Aspects」(切面) 中，按一下「Add」(新增)，將切面附加至資產。
    • 如要查看執行個體的成員資料庫，請按一下「Entry List」(項目清單) 分頁標籤，然後點選「Show all children entries in search」(在搜尋中顯示所有子項目)。如果沒有看到「Entry List」(項目清單) 分頁，代表執行個體沒有資料庫。
    • 在「Entry details」(項目詳細資料) 中，查看資產的完整詳細資料。按一下項目名稱，即可向下展開其他項目。

工作流程範例：從執行個體向下鑽研至資料欄

在這個範例工作流程中，您會先搜尋 Cloud SQL 執行個體，然後查看成員資料庫、該資料庫中的資料表，以及資料表中的資料欄。

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

    前往「Search」(搜尋) 頁面

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

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

  4. 選取執行個體名稱。

  5. 在「Cloud SQL details」(Cloud SQL 詳細資料) 頁面中，按一下「Entry list」(項目清單) 分頁標籤，然後按一下「Show all children entries in search」(在搜尋中顯示所有子項目)。Knowledge Catalog 會顯示執行個體中的資料庫。

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

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

  8. 選用：如要將切面類型新增至資料欄，請按一下「Add aspect」(新增切面) 按鈕。

這個工作流程示範如何從執行個體向下鑽研至資料表。在搜尋欄位中輸入 system=Cloud_SQL AND type=Table，即可直接前往資料表清單。

定價

在 Knowledge Catalog 儲存 Cloud SQL 技術中繼資料，不需支付任何費用。API 呼叫和額外業務中繼資料擴充功能，則適用標準 Knowledge Catalog 定價。詳情請參閱 Knowledge Catalog 定價頁面。

資源使用情況

啟用 Knowledge Catalog 整合功能後，Knowledge Catalog 會定期從執行個體擷取資料。擷取程序需要一定的 CPU 使用量。

與 Knowledge Catalog 近乎即時整合的執行個體，通常對 CPU 使用率的影響極小。如果執行個體每天與 Knowledge Catalog 整合一次，CPU 使用率可能會較高。如果執行個體採用較小的機型 (例如具有共用核心和較大結構定義 (10,000 個以上的資料表) 的機器)，這種情況會特別明顯，在擷取過程中最多可能使用 40% 的 CPU。如果執行個體採用較小的機型 (例如具有共用核心和較大結構定義 (10,000 個以上的資料表) 的機器)，在擷取過程中最多會使用 40% 的 CPU。

限制

本節列出使用 Cloud SQL 和 Knowledge Catalog 的限制。

  • 如果執行個體是在 2026 年 4 月 18 日前建立，且因資源註冊 Assured Workloads 而限制資源存取權，則 Cloud SQL 與 Knowledge Catalog 的整合功能會關閉。

  • 在執行個體啟用 Knowledge Catalog 後，Cloud SQL 資源可能需要 2 到 48 小時，才會在 Knowledge Catalog 中顯示為資產，具體時間取決於您使用的機器大小、版本和 Cloud SQL 引擎類型。

如果執行個體近乎即時更新 (如「近乎即時」一節所述)，則不適用這項限制。

  • 如果 SQL Server 資料庫已啟用 Auto Close 選項，就無法將結構定義資訊同步至 Knowledge Catalog。一般最佳做法和效能考量，建議您在 SQL Server 中將 Auto Close 選項設為 false。不過，如要使用 Knowledge Catalog，則必須將 Auto Close 選項設為 false。如果是 Express 版本，根據 SQL Server 引擎的設計，Auto Close 選項預設會設為 true。

只有在執行個體近乎即時更新時 (如「近乎即時」一節所述)，才適用下列限制：

  • 重新命名資料庫時，只有資料庫更新會近乎即時地顯示在 Knowledge Catalog 中。資料庫和所有相關資料表的基礎對應關係，最終會在 Knowledge Catalog 中保持最終一致。
  • 執行個體可能會捨棄訊息，導致 Knowledge Catalog 中的資料最終才達到一致。如果訊息遭到捨棄，錯過的更新最終會顯示在 Knowledge Catalog 中。執行個體可能捨棄訊息的情況包括：
    • 在短時間內 DDL 速率偏高的執行個體。
    • 現有執行個體的複製版本。
    • 從備份還原的執行個體。
    • 記憶體不足的執行個體。
    • 正在重新啟動或重新啟動資料庫的執行個體。
    • 執行個體發生網路問題，或與 Knowledge Catalog 的同步處理程序中斷。

後續步驟