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

查看執行個體資訊

MySQL | PostgreSQL | SQL Server

本頁面說明如何查看 Cloud SQL 執行個體的相關資訊。

查看執行個體摘要資訊

您可以透過 Google Cloud 控制台、gcloud CLI 或 API，查看 Cloud SQL 執行個體的摘要資訊。

控制台

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

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

系統會顯示已啟用 Private Service Connect 的 Cloud SQL 執行個體相關資訊：
- 內部連線方法：是否使用 Private Service Connect 或私人服務存取權連線至執行個體
- 私人 IP 位址：虛擬私有雲網路中 Private Service Connect 端點的 IP 位址，這些端點會連線至執行個體的服務連結
- DNS 名稱：執行個體的 DNS 名稱
如要查看目前的執行個體狀態，請將游標移到執行個體名稱旁的狀態圖示上。
點選執行個體名稱，開啟執行個體的「總覽」頁面。

在「Connect to this instance」(連線至這個執行個體) 資訊卡中，會顯示下列有關已啟用 Private Service Connect 的 Cloud SQL 執行個體額外資訊：
- 「私人 IP 連線能力」：狀態為「已啟用」，因為執行個體必須有內部 IP 位址
- 允許的專案：這些專案允許從 Private Service Connect 端點連至執行個體
- 服務連結：執行個體的服務連結
- 公開 IP 連線：狀態為「已停用」，因為不支援外部 IP 連線
如要查看執行個體的連線能力資訊，包括執行個體是否新增內部或外部 IP 位址、與執行個體相關聯的任何授權網路，以及其他 Google Cloud 服務 (例如 BigQuery) 是否能透過內部連線存取 Cloud SQL 中的資料並查詢這些資料，請按一下「連線」分頁標籤。

如要進一步瞭解這個分頁，請參閱「關於連線選項」。
按一下 [Networking] (網路) 分頁標籤。系統會顯示已啟用 Private Service Connect 的執行個體相關資訊：
- 「私人 IP」核取方塊已勾選，但處於停用狀態。執行個體必須有內部 IP 位址，且這項設定無法變更。
- 執行個體允許的專案。
- 「公開 IP」核取方塊已勾選，但處於停用狀態。
- 執行個體使用不支援這項功能的 Private Service Connect，因此「Authorized networks」(授權網路) 欄位已停用。

gcloud

如要瞭解如何安裝及開始使用 gcloud CLI，請參閱「安裝 gcloud CLI」。如要瞭解如何啟動 Cloud Shell，請參閱「使用 Cloud Shell」。

如要查看執行個體的摘要資訊，請使用 gcloud sql instances describe 指令：

gcloud sql instances describe INSTANCE_NAME \
--project=PROJECT_ID

請依指示取代下列項目：

INSTANCE_NAME：Cloud SQL 執行個體的名稱。如果這個執行個體已啟用 Private Service Connect，虛擬私有雲網路中的 Private Service Connect 端點就能連線至該執行個體。
PROJECT_ID：執行個體所在 Google Cloud 專案的 ID 或專案編號。

以下是執行這個指令的輸出內容範例：

gcloud sql instances describe myinstance \
--project=12345
...
dnsName: mydnsname
...
pscServiceAttachmentLink: projects/myproject/regions/myregion/serviceAttachments/myserviceattachment
...
 settings:
  ...
  ipConfiguration:
  ipv4Enabled: false
  pscConfig:
    allowedConsumerProjects:
      - projects/23456
      - projects/34567
    pscEnabled: true

如要查看已啟用 Private Service Connect 的執行個體詳細資訊，請新增下列參數：

設定	參數	附註
DNS 名稱	`dnsName`	執行個體的 DNS 名稱。建議您使用這個名稱建立 DNS 記錄，並指向 Private Service Connect 端點的 IP 位址。此外，建議您使用這個名稱連線至執行個體。
服務連結	`pscServiceAttachmentLink`	指向執行個體服務連結的 URI。使用這個 URI 建立 Private Service Connect 端點。
允許的用戶專案	`allowedConsumerProjects`	執行個體的允許專案清單。您可以從這些專案中的任何虛擬私有雲網路，建立 Private Service Connect 端點，連至執行個體的服務連結。
啟用 Private Service Connect	`pscEnabled`	執行個體是否已啟用 Private Service Connect。

REST v1

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

PROJECT_ID：執行個體所在 Google Cloud 專案的 ID 或專案編號。
INSTANCE_NAME：Cloud SQL 執行個體的名稱。如果這個執行個體已啟用 Private Service Connect，虛擬私有雲網路中的 Private Service Connect 端點就能連線至該執行個體。

HTTP 方法和網址：

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

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

curl (Linux、macOS 或 Cloud Shell)

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

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

如果執行個體已啟用 Private Service Connect，則會包含下列欄位：

allowedConsumerProjects：執行個體的允許專案清單。您可以從這些專案中的任何虛擬私有雲網路，建立 Private Service Connect 端點，連至執行個體的服務連結。
pscEnabled：執行個體是否已啟用 Private Service Connect。
pscServiceAttachmentLink：指向執行個體服務連結的 URI。使用這個 URI 建立 Private Service Connect 端點。
dnsName：執行個體的 DNS 名稱。建議您使用這個名稱建立 DNS 記錄，並指向 Private Service Connect 端點的 IP 位址。此外，建議您使用這個名稱連線至執行個體。

如要瞭解如何建構這項工作的基礎 REST API 要求，請參閱 instances:get 頁面。

REST v1beta4

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

PROJECT_ID：執行個體所在 Google Cloud 專案的 ID 或專案編號。
INSTANCE_NAME：Cloud SQL 執行個體的名稱。如果這個執行個體已啟用 Private Service Connect，虛擬私有雲網路中的 Private Service Connect 端點就能連線至該執行個體。

HTTP 方法和網址：

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

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

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "MYSQL_8_0",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "db-custom-2-7680",
    "kind": "sql#settings",
    "availabilityType": "REGIONAL",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "pscConfig": {
        "allowedConsumerProjects": [
          "ALLOWED_PROJECTS"
        ],
        "pscEnabled": true
      },
      "ipv4Enabled": false
    },
  ...
  "createTime": "2023-06-14T18:48:34.975Z",
  "sqlNetworkArchitecture": "NEW_NETWORK_ARCHITECTURE",
  "pscServiceAttachmentLink": "projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_ID",
  "dnsName": "DNS_NAME"
}

如果執行個體已啟用 Private Service Connect，則會包含下列欄位：

allowedConsumerProjects：執行個體的允許專案清單。您可以從這些專案中的任何虛擬私有雲網路，建立 Private Service Connect 端點，連至執行個體的服務連結。
pscEnabled：執行個體是否已啟用 Private Service Connect。
pscServiceAttachmentLink：指向執行個體服務連結的 URI。使用這個 URI 建立 Private Service Connect 端點。
dnsName：執行個體的 DNS 名稱。建議您使用這個名稱建立 DNS 記錄，並指向 Private Service Connect 端點的 IP 位址。此外，建議您使用這個名稱連線至執行個體。

頂端可能會顯示一些橫幅，建議您採取某些行動。

查看寫入端點

寫入端點是全域網域名稱服務 (DNS) 名稱，會自動解析為目前主要執行個體的 IP 位址。如果副本執行容錯移轉或切換作業，這個端點會自動將傳入連線重新導向至新的主要執行個體。您可以在 SQL 連線字串中使用寫入端點，而非 IP 位址。使用寫入端點，即可避免在區域中斷時變更應用程式連線。

如要進一步瞭解如何使用寫入端點連線至執行個體，請參閱「使用寫入端點連線至執行個體」。

指標

這個部分提供重要執行個體指標的用量圖表，可用於監控執行個體。使用指標資料時，請注意下列事項：

指標的資料點是執行個體託管的所有資料庫匯總值。
資料會以當地時間回報。如要進一步瞭解時區，請參閱「支援的旗標」。
轉譯的圖表不會自動重新整理，您必須重新整理頁面才能查看新資料。
在記錄指標資料與資料顯示在使用量圖表的時間之間會有幾分鐘的延遲。

如要進一步瞭解圖表中顯示的指標，請參閱「監控 Cloud SQL 執行個體」。

如要查看 Cloud Monitoring 提供的 Cloud SQL 指標完整清單，請參閱 Cloud SQL 指標清單。

如要進一步瞭解如何搭配使用 Cloud Monitoring 和 Google Cloud，請參閱 Cloud Monitoring 說明文件。

連線至這個執行個體

在「Connect to this instance」(連線至這個執行個體) 區段中，您可以找到執行個體的 IP 位址、虛擬私有雲網路和連線名稱。

如要開啟終端機並連線至執行個體，請按一下「使用 Cloud Shell 連線」。

如要在右側窗格開啟相關教學課程，請點選「從 Compute Engine VM 執行個體連線」。

如要前往「連線選項」，請按一下「查看所有連線方式」。

如要進一步瞭解如何連線至執行個體，請參閱「連線總覽」。

服務帳戶

這個部分會顯示執行個體的服務帳戶電子郵件地址。

詳情請參閱 IAM 服務帳戶說明文件。

設定

這個部分會顯示執行個體目前的設定。

如要變更設定，請按一下「Edit configuration」(編輯設定)。

如要進一步瞭解如何編輯執行個體設定，請參閱「編輯執行個體」。

作業和記錄檔

這個部分會列出最近的執行個體作業，例如建立備份。

如要查看近期作業，請按一下「查看所有作業」。

如要查看記錄資訊，請按一下「View MySQL Error Logs」(查看 MySQL 錯誤記錄)。

如要進一步瞭解「作業」和「Logs Explorer」頁面，請參閱「Cloud SQL 記錄」。

如需記錄功能的一般資訊，請參閱「查看記錄」和「匯出記錄」。

維護

這個部分會顯示目前的維護更新設定和排程。

如要變更偏好設定，請按一下「Edit maintenance preferences」(編輯維護作業偏好設定)。

如要變更通知設定，請按一下「編輯通知偏好設定」。

如要進一步瞭解 Cloud SQL 的維護作業，請參閱「維護作業總覽」。

後續步驟

進一步瞭解 Cloud SQL 的 Cloud Monitoring 指標。
進一步瞭解執行個體設定。
進一步瞭解如何編輯執行個體。

查看執行個體資訊 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

查看執行個體摘要資訊

控制台

gcloud

REST v1

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

查看寫入端點

指標

連線至這個執行個體

服務帳戶

設定

作業和記錄檔

維護

後續步驟

查看執行個體資訊