Ver informações da instância

MySQL   |  PostgreSQL   |  SQL Server

Nesta página, descrevemos como ver informações sobre uma instância do Cloud SQL.

Ver informações resumidas das instâncias

Você pode ver informações resumidas sobre as instâncias do Cloud SQL usando o console do Google Cloud, a gcloud CLI ou a API.

Importante : o Cloud SQL gera um endpoint de gravação automaticamente para a instância do Cloud SQL edição Enterprise Plus. Para mais informações sobre como visualizar esse endpoint, consulte Acessar o endpoint de gravação.

Console

1. No console do Google Cloud, acesse a página Instâncias do Cloud SQL.

   Acesse "Instâncias do Cloud SQL"

   As seguintes informações são exibidas sobre instâncias do Cloud SQL com o Private Service Connect ativado:

   • Método de conexão interna: se o Private Service Connect ou o Private Services Access é usado para se conectar à instância.
   • Endereço IP particular: os endereços IP dos endpoints do Private Service Connect na rede VPC que se conectam ao anexo de serviço da instância
   • Nome do DNS: o nome do DNS da instância

2. Para conferir o estado atual da instância, mantenha o ponteiro do mouse sobre o ícone de status ao lado do nome de uma instância.

   Se a instância estiver no estado FAILED ou MAINTENANCE, é possível recuperar a instância selecionando um horário no passado e restaurando a instância para esse horário.

3. Para abrir a página Visão geral de uma instância, clique no nome da instância.

   No cartão Conectar-se a esta instância, as informações a seguir aparecem sobre as instâncias do Cloud SQL com o Private Service Connect ativado:

   • Conectividade de IP particular: o status é Ativada porque a instância precisa ter um endereço IP interno
   • Projetos permitidos: esses projetos permitem conexões de endpoints do Private Service Connect com a instância
   • Anexo de serviço: o anexo de serviço da instância
   • Conectividade do IP público: o status é Desativada porque as conexões do IP público não são compatíveis

4. Para conferir as informações de conectividade sobre a instância, incluindo se um endereço IP interno ou externo é adicionado à instância, quaisquer redes autorizadas associadas à instância e se outros serviços do Google Cloud, como o BigQuery, pode acessar dados no Cloud SQL e fazer consultas nesses dados em uma conexão interna, clique na guia Conexões.

   Para mais informações sobre essa guia, consulte Sobre as opções de conexão.

5. Clique na guia Rede. As seguintes informações são exibidas sobre as instâncias que têm o Private Service Connect ativado:

   • A caixa de seleção IP privado está marcada, mas desativada. A instância precisa ter um endereço IP interno, e essa configuração não pode ser alterada.
   • Os projetos permitidos para a instância.
   • A caixa de seleção IP público está marcada, mas desativada.
   • O campo Redes autorizadas está desativado porque a instância usa o Private Service Connect, que não é compatível com esse recurso.

gcloud

Para informações sobre como instalar e dar os primeiros passos com a CLI gcloud, consulte Instalar a CLI gcloud. Para mais informações sobre como iniciar o Cloud Shell, consulte Usar o Cloud Shell.

1. Para ver informações resumidas sobre uma instância, use o comando gcloud sql instances describe:

   gcloud sql instances describe INSTANCE_NAME \
   --project=PROJECT_ID

   Faça as seguintes substituições:

   • INSTANCE_NAME: o nome da instância do Cloud SQL. Se o Private Service Connect estiver ativado nessa instância, os endpoints do Private Service Connect nas redes VPC poderão se conectar a ela.
   • PROJECT_ID: o ID ou número do projeto do Google Cloud que contém a instância.

   Veja um exemplo da saída para executar este comando:

   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

2. Para ver informações mais detalhadas sobre instâncias que têm o Private Service Connect ativado, adicione os seguintes parâmetros:

Configuração	Parâmetro	Observações
Nome do DNS	dnsName	O nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e aponte-o para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.
Anexo de serviço	pscServiceAttachmentLink	O URI que aponta para o anexo do serviço da instância. Use esse URI para criar o endpoint do Private Service Connect.
Projetos consumidores permitidos	allowedConsumerProjects	Uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
Como ativar o Private Service Connect	pscEnabled	Se uma instância tem o Private Service Connect ativado.

Observação: para conseguir o endpoint de gravação da sua instância do Cloud SQL, use o comando gcloud sql instances describe. Esse endpoint é o valor associado ao parâmetro psaWriteEndpoint.

Terraform

Para criar uma instância, use um recurso do 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
}

Aplique as alterações

Para aplicar a configuração do Terraform em um projeto do Google Cloud, conclua as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto padrão do Google Cloud em que você quer aplicar as configurações do Terraform.

   Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o arquivo é chamado de main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.

   Copie o exemplo de código no main.tf recém-criado.

   Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve as alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Revise a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça as correções necessárias na configuração.

2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Apply complete!".

3. Abra seu projeto do Google Cloud para ver os resultados. No console do Google Cloud, navegue até seus recursos na IU para verificar se foram criados ou atualizados pelo Terraform.

Observação: as amostras do Terraform geralmente presumem que as APIs necessárias estejam ativadas no projeto do Google Cloud.

Excluir as alterações

Para excluir as mudanças, faça o seguinte:

1. Para desativar a proteção contra exclusão, no arquivo de configuração do Terraform, defina o argumento deletion_protection como false.

   deletion_protection =  "false"

2. Para aplicar a configuração atualizada do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

3. Remova os recursos aplicados anteriormente com a configuração do Terraform executando o seguinte comando e inserindo yes no prompt:

   terraform destroy

REST v1

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID ou número do projeto do Google Cloud que contém a instância.
• INSTANCE_NAME: o nome da instância do Cloud SQL. Se o Private Service Connect estiver ativado nessa instância, os endpoints do Private Service Connect nas redes VPC poderão se conectar a ela.

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

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

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

Os campos a seguir existem para instâncias que têm o Private Service Connect ativado:

• allowedConsumerProjects: uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
• pscEnabled: se uma instância tem o Private Service Connect ativado para ela.
• pscServiceAttachmentLink: o URI que aponta para o anexo de serviço da instância. Use esse URI para criar o endpoint do Private Service Connect.
• dnsName: é o nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e aponte-o para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.

Para ver como criar a solicitação da API REST subjacente desta tarefa, consulte a página instances:get.

Observação: para acessar o endpoint de gravação da sua instância do Cloud SQL, use o método instances:get. Esse endpoint é o valor associado ao parâmetro psaWriteEndpoint.

REST v1beta4

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

• PROJECT_ID: o ID ou número do projeto do Google Cloud que contém a instância.
• INSTANCE_NAME: o nome da instância do Cloud SQL. Se o Private Service Connect estiver ativado nessa instância, os endpoints do Private Service Connect nas redes VPC poderão se conectar a ela.

Método HTTP e URL:

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

Para enviar a solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

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)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:

$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

Você receberá uma resposta JSON semelhante a esta:

{
  "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"
}

Os campos a seguir existem para instâncias que têm o Private Service Connect ativado:

• allowedConsumerProjects: uma lista dos projetos permitidos para a instância. Você pode criar endpoints do Private Service Connect de qualquer rede VPC nesses projetos para o anexo de serviço da instância.
• pscEnabled: se uma instância tem o Private Service Connect ativado para ela.
• pscServiceAttachmentLink: o URI que aponta para o anexo de serviço da instância. Use esse URI para criar o endpoint do Private Service Connect.
• dnsName: é o nome DNS da instância. Recomendamos que você crie um registro DNS com esse nome e aponte-o para o endereço IP do endpoint do Private Service Connect. Também recomendamos que você use esse nome para se conectar à instância.

Observação: para acessar o endpoint de gravação da sua instância do Cloud SQL, use o método instances:get. Esse endpoint é o valor associado ao parâmetro psaWriteEndpoint.

Talvez você veja alguns banners na parte superior sugerindo ações que podem ser realizadas.

Conferir o endpoint de gravação

Visualização

Este produto está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço Gerais" dos Termos Específicos do Serviço. Os produtos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

Um endpoint de gravação é um nome de serviço de nome de domínio (DNS) global que se refere ao endereço IP da instância principal atual de forma automática. Esse endpoint redireciona as conexões de entrada para a nova instância principal automaticamente no caso de uma operação de failover ou alternância da réplica. É possível usar o endpoint de gravação em uma string de conexão SQL em vez de um endereço IP. Ao usar um endpoint de gravação, você evita ter que fazer mudanças na conexão do aplicativo quando ocorre uma interrupção regional.

O Cloud SQL gera um endpoint de gravação automaticamente para a instância do Cloud SQL edição Enterprise Plus se você fizer o seguinte:

1. Ative a API Cloud DNS para seu projeto do Google Cloud.

2. Crie a instância.

   Observação : é importante que a instância seja criada com a nova arquitetura de rede. Caso contrário, faça upgrade da instância para a nova arquitetura de rede.
3. Selecione Enterprise Plus como a edição do Cloud SQL para sua instância.
4. Adicione um endereço IP particular à instância.
5. Especifique uma rede associada à instância.
6. Opcionalmente, especifique um intervalo de IP alocado para a instância.

Se você já tiver uma instância do Cloud SQL edição Enterprise Plus e quiser que o Cloud SQL gere um endpoint de gravação automaticamente, crie uma réplica ativada para recuperação avançada de desastres.

Para mais informações sobre como recuperar o endpoint de gravação e usá-lo para se conectar à instância, consulte Conectar usando um endpoint de gravação.

Métricas

Nesta seção, você verá gráficos de uso das principais métricas de instância que podem ser usadas para monitorar instâncias Ao trabalhar com dados de métricas, tenha isto em mente:

• Um ponto de dados de uma métrica é um agrupamento de todos os bancos de dados hospedados pela instância.
• Os dados são informados no horário local.
• Os gráficos renderizados não são atualizados automaticamente. Para ver dados novos, é necessário atualizar a página.
• A exibição dos dados de métrica nos gráficos de uso leva alguns minutos após o registro.

Para mais informações sobre as métricas exibidas no gráfico, consulte Como monitorar instâncias do Cloud SQL.

Para uma lista completa das métricas do Cloud SQL fornecidas pelo Cloud Monitoring, consulte esta página.

Para mais informações sobre como usar o Cloud Monitoring com o Google Cloud, consulte a documentação relacionada.

Conectar-se a esta instância

Na seção Conectar-se a esta instância, você encontra os endereços IP da instância, a rede VPC e o nome da conexão.

Para abrir um terminal e se conectar à instância, clique em Conectar usando o Cloud Shell.

Para abrir um tutorial relacionado no painel direito, clique em Conectar-se de uma instância de VM do Compute Engine.

Para acessar Opções de conexão, clique em Ver todos os métodos de conexão.

Para mais informações sobre como se conectar a uma instância, consulte Visão geral da conexão.

Conta de serviço

Esta seção mostra o endereço de e-mail da conta de serviço da instância.

Para mais informações, consulte a documentação de contas de serviço do IAM.

Configuração

Nesta seção, você verá as configurações atuais da instância.

Para alterar as configurações, clique em Editar configurações.

Para mais informações sobre como editar a configuração de uma instância, consulte Como editar uma instância.

Operações e registros

Nesta seção, você verá uma lista das operações recentes da instância, como backups.

Para ver as operações recentes, clique em Ver todas as operações.

Para ver informações sobre registro, clique em Ver registros de erro do PostgreSQL.

Para mais informações sobre as páginas "Operações" e "Explorador de registros", consulte Geração de registros do Cloud SQL.

Para informações gerais sobre geração de registros, consulte Como visualizar registros e Como exportar registros.

Manutenção

Nesta seção, você vê as configurações e a programação de atualização de manutenção atuais.

Para alterar suas preferências, clique em Editar preferências de manutenção.

Para mudar as configurações de notificação, clique em Editar preferências de notificação.

Para mais informações sobre manutenção no Cloud SQL, consulte Visão geral de manutenção.

A seguir

• Saiba mais sobre as métricas do Cloud Monitoring para Cloud SQL.
• Saiba mais sobre configurações de instância.
• Saiba mais sobre como editar uma instância.