本頁說明如何使用 Knowledge Catalog 搜尋及管理 Cloud SQL 資源。
Knowledge Catalog 是一個平台，可儲存、管理及存取中繼資料。Knowledge Catalog 會自動從 Cloud SQL 執行個體、資料庫、資料表、資料欄和檢視區塊擷取下列中繼資料：
- 名稱
- 位置 (區域)
- 建立日期和上次修改日期
- 結構定義 (適用於資料表和檢視表)
- 說明
- 主鍵和外鍵限制
Knowledge Catalog 只會從 Cloud SQL 主要執行個體擷取中繼資料，不會從唯讀副本或外部伺服器副本擷取。
您可以使用 Knowledge Catalog 探索及瞭解 Cloud SQL 中繼資料。使用 Knowledge Catalog 協助執行下列活動：
- 資料探索
- 分類
- 分析，包括依附元件和是否適合用途
- 變更管理
- 資料遷移 (管道)
- 漸進式結構定義更新
透過 Knowledge Catalog，您可以將各個層面附加至 Cloud SQL 中繼資料項目，藉此管理中繼資料。每個層面可有多個中繼資料欄位，且可根據預先定義或自訂的層面類型。
舉例來說，您可能會將下列層面附加至包含身分證字號 (個人識別資訊) 的資料欄：
pii:true
pii_type:SSN
如要進一步瞭解 Knowledge Catalog，請參閱「關於 Knowledge Catalog 中的中繼資料管理」。
Knowledge Catalog 整合資料更新間隔
Knowledge Catalog 中執行個體中繼資料的預期更新頻率，取決於執行個體的建立日期和資料庫版本。
近乎即時
如果執行個體符合所有下列條件，系統預設會在建立執行個體時啟用與 Knowledge Catalog 的整合功能：
建立時間：2026 年 4 月 18 日當天或之後
- 版本：PostgreSQL 適用的 Cloud SQL 14.0 以上版本
- 網路架構： 新網路架構
如果執行個體不符合所有條件，請參閱「每天一次」一節。
如果執行個體符合所有這些條件，系統就會建立執行個體，其中包含時間戳記資料表，可追蹤資產的建立和更新時間。時間戳記資料表位於 cloudsqladmin 資料庫。
當執行個體有 DDL 或結構定義變更時，整合會查詢時間戳記表格，找出最近變更的資產，然後近乎即時地將最新的結構定義更新載入 Knowledge Catalog。在極少數情況下 (例如網路不穩定)，Knowledge Catalog 可能會錯過更新。雖然這種情況很少發生，但系統最終會保持一致性，通常會在 24 小時內補上所有遺漏的變更。如要進一步瞭解可能導致錯過變更的狀況，請參閱本頁的「限制」一節。
查看在執行個體中執行的查詢時，您會看到支援 Knowledge Catalog 整合的查詢。你可以透過查詢中包含的 --Dataplex 註解，識別這些查詢。如要查看執行個體的查詢，請參閱「查看執行中的查詢」。
您可以停用整合功能，然後按照「更新執行個體」一文中的說明，稍後重新啟用。
一天一次
如果執行個體符合任何下列條件，即可啟用與 Knowledge Catalog 的整合功能：
- 建立時間：2026 年 4 月 18 日前
- 版本：PostgreSQL 適用的 Cloud SQL 14.0 之前的版本
- 網路架構： 舊網路架構
如果執行個體是在 2026 年 4 月 18 日後建立，系統預設會啟用與 Knowledge Catalog 的整合功能。如果是 2026 年 4 月 18 日前建立的執行個體，可以在現有的 Cloud SQL 執行個體上啟用 Knowledge Catalog 整合功能 。
啟用與 Knowledge Catalog 的整合功能後，系統通常會每天在 Knowledge Catalog 中重新整理一次符合下列任一條件的執行個體中繼資料。您可以停用 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
為專案啟用 Dataplex API。
-
請檢查權限。
您需要特定 Identity and Access Management (IAM) 角色和權限，才能搜尋項目並將項目附加至 Cloud SQL 資產。詳情請參閱「知識目錄所需的 IAM 角色和權限」。
知識型錄所需的 IAM 角色和權限
Cloud SQL 會使用 cloudsql.schemas.view 權限，提供 Knowledge Catalog 中繼資料的存取權。
如要提供這項權限，請建立包含這項權限的自訂角色，或使用具備這項權限的預先定義角色。
詳情請參閱「預先定義的 Cloud SQL IAM 角色」。
建立已啟用 Knowledge Catalog 整合功能的執行個體
根據預設，新例項會與 Knowledge Catalog 整合。如要建立已啟用 Knowledge Catalog 整合功能的新執行個體，只要建立新的執行個體即可。如要建立整合 Knowledge Catalog 的執行個體，且近乎即時，新執行個體必須符合所有下列條件：
建立時間：2026 年 4 月 18 日當天或之後
- 版本：PostgreSQL 適用的 Cloud SQL 14.0 以上版本
- 網路架構： 新網路架構
如要為使用舊版資料庫或舊網路架構的新執行個體啟用近乎即時的 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：執行個體的資料庫版本 (例如
POSTGRES_14)。如需可用字串的完整清單，請參閱 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 日前
- 版本：PostgreSQL 適用的 Cloud SQL 14.0 之前的版本
- 網路架構： 舊網路架構
您也可以按照本節的更新說明，在先前與 Knowledge Catalog 近乎即時整合的執行個體上，重新啟用 Knowledge Catalog 整合功能。重新啟用整合服務後，系統最多需要 10 分鐘，才會開始在 Knowledge Catalog 中顯示近乎即時的資料。
如要在現有的 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 分鐘。
控制台
-
前往 Google Cloud 控制台的「Cloud SQL Instances」頁面。
- 如要開啟執行個體的「總覽」頁面，請按一下執行個體名稱。
- 按一下 [編輯]。
- 在「自訂執行個體」部分，展開「顯示設定選項」選單。
在「Flags and parameters」(旗標和參數) 部分，取消勾選「Enable Knowledge Catalog integration」(啟用知識目錄整合) 核取方塊。
- 按一下 [儲存]。
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 資產
切面類型是可重複使用的資源，可做為切面的範本。切面類型可協助您避免重複作業和不完整的切面。您可以使用知識目錄建立所需的切面類型。
建立自訂切面類型後，即可將切面附加至 Cloud SQL 資產。將構面附加至 Cloud SQL 資產，即可執行下列操作：
- 在資產中新增商家中繼資料
- 依業務中繼資料和其他自訂中繼資料搜尋資產
如要進一步瞭解如何建立構面類型，以及將構面附加至 Cloud SQL，請參閱「管理構面及豐富中繼資料」。
搜尋 Cloud SQL 資產
在 Google Cloud 控制台中，使用知識目錄搜尋頁面搜尋 Cloud SQL 資產。
前往 Knowledge Catalog 的「Search」(搜尋) 頁面。
在「選擇搜尋平台」中，選取「Knowledge Catalog」。
在「篩選器」面板中，按一下「系統」，然後選取「Cloud SQL」。
選用。在「型別別名」中，您可以選取一或多個下列型別別名，將搜尋結果篩選為特定類型的 Cloud SQL 資產：
- 資料庫
- 資料庫結構定義
- 服務
- 資料表
- 查看
使用查詢執行搜尋
您也可以使用知識目錄中的搜尋欄位執行搜尋查詢。如要查看所有 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 |
|
| PostgreSQL 適用的 Cloud SQL |
|
| SQL Server 適用的 Cloud SQL |
|
查詢範例如下：
type="projects/dataplex-types/locations/global/entryTypes/cloudsql-postgresql-instance"
依 Cloud SQL 方言篩選 Cloud SQL 資產
根據預設，知識目錄會顯示所有 Cloud SQL 資產。如要只篩選 MySQL 適用的 Cloud SQL、PostgreSQL 適用的 Cloud SQL 或 SQL Server 的資產，請按照下列步驟操作。
在「Aspects」(層面) 面板中，按一下「Add more aspect types」(新增更多層面類型) 選單。
選取「SQL Access」(SQL 存取權)。
按一下 [確定]。
按一下「playlist_add」 編輯切面按鈕。在「SQL Access」(SQL 存取權) 頁面中，執行下列操作：
- 在「方言」欄位中，選取「PostgreSQL」，篩選出 PostgreSQL 適用的 Cloud SQL 資產。
- 選用。選取「版本」欄位，然後輸入特定版本的 PostgreSQL 適用的 Cloud SQL。
按一下 [套用]。知識目錄只會顯示 PostgreSQL 適用的 Cloud SQL 資產。
依切面類型搜尋
知識目錄內建幾種切面類型，可用於執行搜尋。
在「Aspects」(層面) 面板中，按一下「Add more aspect types」(新增更多層面類型) 選單。
選用。選取「SQL 存取權」，依 Cloud SQL 方言篩選結果。詳情請參閱先前的程序「依 Cloud SQL 方言篩選 Cloud SQL 資產」。
選取下列一或多個面向類型，將搜尋結果限制為該類型。
- Cloud SQL 資料庫
- Cloud SQL 執行個體
- Cloud SQL 檢視畫面
- Cloud SQL 結構定義
- Cloud SQL 資料表
按一下 [確定]。
在結果表格中，按一下資產名稱，即可查看該資產的中繼資料。
選用：強化或查看素材資源。您可以執行下列任一操作：
- 在「總覽」中，按一下「新增」，即可新增資產的 RTF 格式說明。
- 在「切面」中，按一下「新增」，將切面附加至資產。
- 舉例來說，如要查看成員資料庫，請按一下「項目清單」分頁標籤，然後按一下「在搜尋中顯示所有子項目」。如果沒有顯示「項目清單」分頁，表示例項沒有資料庫。
- 在「項目詳細資料」中，查看資產的完整詳細資料。按一下項目名稱，即可下鑽至其他項目。
工作流程範例 - 從執行個體向下鑽研至資料欄
在這個範例工作流程中，您會先搜尋 Cloud SQL 執行個體，然後查看成員資料庫，接著查看該資料庫中的資料表，最後查看資料表中的資料欄。
前往 Knowledge Catalog 的「Search」(搜尋) 頁面。
在「選擇搜尋平台」選項中，選取「Knowledge Catalog」。
在「篩選器」面板中，依序選取「系統」和「Cloud SQL」。或者，在搜尋欄位中輸入
system=Cloud_SQL。選取執行個體名稱。
在「Cloud SQL details」(Cloud SQL 詳細資料) 頁面中，按一下「Entry list」(項目清單) 分頁標籤，然後按一下「Show all children entries in search」(在搜尋結果中顯示所有子項目)。 知識目錄會顯示執行個體中的資料庫。
在「Cloud SQL database details」(Cloud SQL 資料庫詳細資料) 頁面中，按一下「Entry list」(項目清單) 分頁標籤，然後按一下「View child entries in search」(在搜尋中查看子項目)。知識目錄會顯示資料庫中的資料表。
選取資料表名稱，然後在「Cloud SQL table details」(Cloud SQL 資料表詳細資料) 頁面上，按一下「Schema」(結構定義)，即可查看資料表欄。
選用：如要為欄新增層面類型，請按一下「新增層面」按鈕。
這個工作流程示範如何從執行個體向下鑽研至資料表。在搜尋欄位中輸入 system=Cloud_SQL AND type=Table，即可直接前往資料表清單。
定價
在 Knowledge Catalog 中儲存 Cloud SQL 技術中繼資料無須付費。API 呼叫和額外商業中繼資料擴充功能適用標準 Knowledge Catalog 定價。詳情請參閱 Knowledge Catalog 定價頁面。
資源使用情況
啟用 Knowledge Catalog 整合功能後，Knowledge Catalog 會定期從執行個體擷取資料。擷取程序需要一定量的 CPU 使用率。與 Knowledge Catalog 近乎即時整合的執行個體，以及 2026 年 4 月 18 日後建立的其他執行個體，通常對 CPU 使用量影響極小。對於 2026 年 4 月 18 日前建立的大多數執行個體 (包括 2026 年 3 月 19 日前建立的所有執行個體)，CPU 使用率可能會更高。如果執行個體使用較小的機器類型，例如共用核心的機器和較大的結構定義 (10,000 個以上的表格)，這種情況就特別明顯，因為在擷取程序期間，這類機器可能會耗用高達 40% 的 CPU。
限制
本節列出使用 Cloud SQL 和 Knowledge Catalog 時的限制。
如果是 2026 年 4 月 18 日前建立的執行個體，如果資源已註冊 Assured Workloads，導致執行個體無法存取資源，系統會停用 Knowledge Catalog 與 Cloud SQL 的整合功能。
在執行個體上啟用 Knowledge Catalog 後，Cloud SQL 資源可能需要 2 到 48 小時才會在 Knowledge Catalog 中顯示為資產，具體時間取決於您使用的 Cloud SQL 引擎機器大小、版本和類型。如果執行個體近乎即時更新 (如「 近乎即時」一節所述)，就不會受到這項限制。
您設定為高可用性 (HA) 的執行個體不會在建立時自動啟用 Knowledge Catalog。如果為已啟用 Knowledge Catalog 的執行個體啟用高可用性，除非關閉 Knowledge Catalog，否則該功能會維持啟用狀態。
- 資料庫重新命名後，只有資料庫更新會近乎即時地顯示在知識目錄中。資料庫和所有相關資料表的基礎對應關係，最終會在 Knowledge Catalog 中保持一致。
- 如果執行個體已啟用 VPC Service Controls，則不支援近乎即時的 Knowledge Catalog 整合功能。
- 執行個體可能會捨棄訊息，導致 Knowledge Catalog 中的資料最終只會保持一致。如果訊息遭到捨棄，最終會在 Knowledge Catalog 中顯示遺漏的更新。執行個體可能會捨棄訊息的情況包括：
- 在短時間內發生大量 DDL 的執行個體。
- 現有執行個體的副本。
- 從備份還原的執行個體。
- 記憶體不足的執行個體。
- 正在重新啟動或重新啟動資料庫的執行個體。
- 發生網路問題或與 Knowledge Catalog 的同步程序中斷的執行個體。