查看实例信息

MySQL | PostgreSQL | SQL Server

本页介绍如何查看有关 Cloud SQL 实例的信息。

查看实例摘要信息

您可以使用 Google Cloud 控制台、gcloud CLI 或 API 查看有关 Cloud SQL 实例的摘要信息。

控制台

在 Google Cloud 控制台中，转到 Cloud SQL 实例页面。

转到“Cloud SQL 实例”

系统会显示有关启用了 Private Service Connect 的 Cloud SQL 实例的以下信息：
- 内部连接方法：连接到实例时使用的是 Private Service Connect 还是专用服务访问通道
- 专用 IP 地址：VPC 网络中连接到实例的服务连接的 Private Service Connect 端点的 IP 地址
- DNS 名称：实例的 DNS 名称
如需查看当前实例状态，请将指针悬停在实例名称旁边的状态图标上。

如果实例处于 FAILED 或 MAINTENANCE 状态，则您可以通过选择一个过去的时间并将实例恢复到该时间的状态来恢复实例。
如需打开实例的概览页面，请点击实例名称。

连接到此实例卡片会显示有关启用了 Private Service Connect 的 Cloud SQL 实例的以下额外信息：
- 专用 IP 连接：状态为已启用，因为实例必须具有内部 IP 地址
- 允许的项目：这些项目允许从 Private Service Connect 端点连接到实例
- 服务连接：实例的服务连接
- 公共 IP 连接：状态为已停用，因为外部 IP 连接不受支持
如需查看有关实例的连接信息，包括是否向实例和任何与实例关联的已获授权的网络添加了内部或外部 IP 地址，以及其他 Google Cloud 服务（例如 BigQuery）是否可以访问 Cloud SQL 中的数据并通过内部连接对此数据进行查询，请点击连接标签页。

如需详细了解此标签页，请参阅连接选项简介。
点击网络标签页。系统会显示有关启用了 Private Service Connect 的实例的以下信息：
- 专用 IP 复选框处于选中状态，但已停用。实例必须具有内部 IP 地址，并且此设置无法更改。
- 实例允许的项目。
- 公共 IP 复选框处于选中状态，但已停用。
- 已获授权的网络字段已停用，因为实例使用不支持此功能的 Private Service Connect。

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，则 VPC 网络中的 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`	实例允许的项目列表。您可以从这些项目中的任何 VPC 网络到实例的服务连接来创建 Private Service Connect 端点。
启用 Private Service Connect	`pscEnabled`	实例是否启用了 Private Service Connect。

Terraform

如需创建实例，请使用 Terraform 资源。

resource "google_sql_database_instance" "postgres_pvp_instance_name" {
  name             = "postgres-pvp-instance-name"
  region           = "asia-northeast1"
  database_version = "POSTGRES_14"
  root_password    = "abcABC123!"
  settings {
    tier = "db-custom-2-7680"
    password_validation_policy {
      min_length                  = 6
      reuse_interval              = 2
      complexity                  = "COMPLEXITY_DEFAULT"
      disallow_username_substring = true
      password_change_interval    = "30s"
      enable_password_policy      = true
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

应用更改

如需在 Google Cloud 项目中应用 Terraform 配置，请完成以下部分中的步骤。

准备 Cloud Shell

启动 Cloud Shell。
设置要在其中应用 Terraform 配置的默认 Google Cloud 项目。

您只需为每个项目运行一次以下命令，即可在任何目录中运行它。
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
如果您在 Terraform 配置文件中设置显式值，则环境变量会被替换。

准备目录

每个 Terraform 配置文件都必须有自己的目录（也称为“根模块”）。

在 Cloud Shell 中，创建一个目录，并在该目录中创建一个新文件。文件名必须具有 .tf 扩展名，例如 main.tf。在本教程中，该文件称为 main.tf。
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
如果您按照教程进行操作，可以在每个部分或步骤中复制示例代码。

将示例代码复制到新创建的 main.tf 中。

（可选）从 GitHub 中复制代码。如果端到端解决方案包含 Terraform 代码段，则建议这样做。
查看和修改要应用到您的环境的示例参数。
保存更改。
初始化 Terraform。您只需为每个目录执行一次此操作。
```
terraform init
```
（可选）如需使用最新的 Google 提供程序版本，请添加 -upgrade 选项：
```
terraform init -upgrade
```

应用更改

查看配置并验证 Terraform 将创建或更新的资源是否符合您的预期：
```
terraform plan
```
根据需要更正配置。
通过运行以下命令并在提示符处输入 yes 来应用 Terraform 配置：
```
terraform apply
```
等待 Terraform 显示“应用完成！”消息。
打开您的 Google Cloud 项目以查看结果。在 Google Cloud 控制台的界面中找到资源，以确保 Terraform 已创建或更新它们。

删除更改

如需删除更改，请执行以下操作：

如需停用删除防护，请在 Terraform 配置文件中将 deletion_protection 参数设置为 false。
```
deletion_protection =  "false"
```
运行以下命令并在提示符处输入 yes，以应用更新后的 Terraform 配置：
```
terraform apply
```

运行以下命令并在提示符处输入 yes，以移除之前使用 Terraform 配置应用的资源：
```
terraform destroy
```

REST v1

在使用任何请求数据之前，请先进行以下替换：

PROJECT_ID：包含实例的 Google Cloud 项目的 ID 或项目编号。
INSTANCE_NAME：Cloud SQL 实例的名称。如果此实例启用了 Private Service Connect，则 VPC 网络中的 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": "POSTGRES_13",
  "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：实例允许的项目列表。您可以从这些项目中的任何 VPC 网络到实例的服务连接来创建 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，则 VPC 网络中的 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": "POSTGRES_13",
  "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：实例允许的项目列表。您可以从这些项目中的任何 VPC 网络到实例的服务连接来创建 Private Service Connect 端点。
pscEnabled：实例是否启用了 Private Service Connect。
pscServiceAttachmentLink：指向实例的服务连接的 URI。使用此 URI 创建 Private Service Connect 端点。
dnsName：实例的 DNS 名称。我们建议您使用此名称创建 DNS 记录，并将其指向 Private Service Connect 端点的 IP 地址。此外，我们还建议您使用此名称连接到实例。

如需了解如何为此任务构建底层 REST API 请求，请参阅 instances:get 页面。

您可能会在顶部看到一些横幅，其中列出了您可能需要执行的操作。

指标

本部分提供了关键实例指标的使用情况图表，可供您用来监控自己的实例。在处理指标数据时，请牢记以下事实：

指标的数据点是由实例托管的所有数据库的聚合数据。
数据按照当地时间报告。
渲染的图表不会自动刷新；要查看新数据，您必须刷新页面。
在指标数据的记录时间与指标数据在使用量图表中显示的时间之间，存在几分钟的延迟。

如需详细了解图表中显示的指标，请参阅监控 Cloud SQL 实例。

如需查看 Cloud Monitoring 所提供 Cloud SQL 指标的完整列表，请参阅 Cloud SQL 指标列表。

如需详细了解如何将 Cloud Monitoring 与 Google Cloud 搭配使用，请参阅 Cloud Monitoring 文档。

连接到此实例

在连接到此实例部分中，您可以找到实例的 IP 地址、VPC 网络和连接名称。

如需打开终端并连接到实例，请点击使用 Cloud Shell 连接。

如需在右侧窗格中打开相关教程，请点击从 Compute Engine 虚拟机实例连接。

如需转到连接选项，请点击查看所有连接方法。

如需详细了解如何连接到实例，请参阅连接概览。

服务账号

本部分介绍了实例的服务账号电子邮件地址。

如需了解详情，请参阅 IAM 服务账号文档。

配置

本部分介绍了实例的当前配置设置。

如需更改配置设置，请点击修改配置。

如需详细了解如何修改实例配置，请参阅修改实例。

操作和日志

本部分列出了最近的实例操作，例如创建备份。

如需查看最近的操作，请点击查看所有操作。

如需查看日志记录信息，请点击查看 PostgreSQL 错误日志 (View PostgreSQL Error Logs)。

如需详细了解操作和日志浏览器页面，请参阅 Cloud SQL 日志记录。

如需了解日志记录的一般信息，请参阅查看日志和导出日志。

维护

本部分介绍了当前的维护更新设置和时间表。

如需更改偏好设置，请点击修改维护偏好设置。

如需更改通知设置，请点击修改通知偏好设置。

如需详细了解 Cloud SQL 中的维护，请参阅维护概览。

后续步骤

详细了解 Cloud SQL 的 Cloud Monitoring 指标。
详细了解实例设置。
详细了解如何修改实例。