Esta página foi traduzida pela API Cloud Translation.

Veja informações da instância

MySQL | PostgreSQL | SQL Server

Esta página descreve como ver informações sobre uma instância do Cloud SQL.

Veja informações de resumo da instância

Pode ver informações de resumo sobre as instâncias do Cloud SQL através da Google Cloud consola, da CLI gcloud ou da API.

Consola

Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

Aceda a Instâncias do Cloud SQL

As seguintes informações são apresentadas sobre as instâncias do Cloud SQL que têm o Private Service Connect ativado:
- Método de ligação interna: se o Private Service Connect ou o acesso privado aos serviços é usado para estabelecer ligação à instância
- Endereço IP privado: os endereços IP dos pontos finais do Private Service Connect na rede VPC que se ligam à associação de serviços da instância
- Nome DNS: o nome DNS da instância
Para ver o estado atual da instância, mantenha o ponteiro sobre o ícone de estado junto ao nome de uma instância.

Se a instância estiver no estado FAILED ou MAINTENANCE, pode recuperar a instância selecionando uma hora do passado e restaurando a instância para o estado em que se encontrava nessa altura.
Para abrir a página Vista geral de uma instância, clique no nome da instância.

No cartão Estabelecer ligação a esta instância, são apresentadas as seguintes informações adicionais sobre as instâncias do Cloud SQL com o Private Service Connect ativado:
- Conetividade de IP privado: o estado é Ativado porque a instância tem de ter um endereço IP interno
- Projetos permitidos: estes projetos permitem ligações de pontos finais do Private Service Connect à instância
- Associação do serviço: a associação do serviço da instância
- Conetividade IP pública: o estado é Desativado porque as ligações IP externas não são suportadas
Para ver informações de conetividade 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 Google Cloud serviços, como o BigQuery, podem aceder a dados no Cloud SQL e fazer consultas a estes dados através de uma ligação interna, clique no separador Ligações.

Para mais informações sobre este separador, consulte o artigo Acerca das opções de ligação.
Clique no separador Rede. As seguintes informações são apresentadas sobre as instâncias que têm o Private Service Connect ativado:
- A caixa de verificação IP privado está selecionada, mas desativada. A instância tem de ter um endereço IP interno e não é possível alterar esta definição.
- Os projetos permitidos para a instância.
- A caixa de verificação IP público está selecionada, mas desativada.
- O campo Redes autorizadas está desativado porque a instância usa o Private Service Connect, que não suporta esta funcionalidade.

gcloud

Para informações sobre a instalação e o início da utilização da CLI gcloud, consulte o artigo Instale a CLI gcloud. Para obter informações sobre como iniciar a Cloud Shell, consulte o artigo Use a Cloud Shell.

Para ver informações de resumo 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 esta instância tiver o Private Service Connect ativado, os pontos finais do Private Service Connect nas redes VPC podem estabelecer ligação à mesma.
- PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância.
Segue-se um exemplo do resultado da execução deste 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
```
Para ver informações mais detalhadas sobre as instâncias que têm o Private Service Connect ativado, adicione os seguintes parâmetros:

Definição	Parâmetro	Notas
Nome de DNS	`dnsName`	O nome DNS da instância. Recomendamos que crie um registo DNS com este nome e o direcione para o endereço IP do ponto final do Private Service Connect. Também recomendamos que use este nome para se ligar à instância.
Associação do serviço	`pscServiceAttachmentLink`	O URI que aponta para a associação de serviço da instância. Use este URI para criar o ponto final do Private Service Connect.
Projetos de consumidor permitidos	`allowedConsumerProjects`	Uma lista dos projetos permitidos para a instância. Pode criar pontos finais do Private Service Connect a partir de quaisquer redes VPC nestes projetos para a associação de serviço da instância.
Ativar o Private Service Connect	`pscEnabled`	Se uma instância tem o Private Service Connect ativado.

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 num Google Cloud projeto, conclua os passos nas secções seguintes.

Prepare o Cloud Shell

Inicie o Cloud Shell.
Defina o Google Cloud projeto predefinido onde quer aplicar as suas configurações do Terraform.

Só tem de executar este comando uma vez por projeto e pode executá-lo em qualquer diretório.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
As variáveis de ambiente são substituídas se definir valores explícitos no ficheiro de configuração do Terraform.

Prepare o diretório

Cada ficheiro de configuração do Terraform tem de ter o seu próprio diretório (também denominado módulo raiz).

No Cloud Shell, crie um diretório e um novo ficheiro nesse diretório. O nome do ficheiro tem de ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o ficheiro é denominado main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Se estiver a seguir um tutorial, pode copiar o código de exemplo em cada secção ou passo.

Copie o exemplo de código para o ficheiro main.tf criado recentemente.

Opcionalmente, copie o código do GitHub. Isto é recomendado quando o fragmento do Terraform faz parte de uma solução completa.
Reveja e modifique os parâmetros de exemplo para aplicar ao seu ambiente.
Guarde as alterações.
Inicialize o Terraform. Só tem de fazer isto uma vez por diretório.
```
terraform init
```
Opcionalmente, para usar a versão mais recente do fornecedor Google, inclua a opção -upgrade:
```
terraform init -upgrade
```

Aplique as alterações

Reveja a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expetativas:
```
terraform plan
```
Faça as correções necessárias à configuração.
Aplique a configuração do Terraform executando o seguinte comando e introduzindo yes no comando:
```
terraform apply
```
Aguarde até que o Terraform apresente a mensagem "Apply complete!" (Aplicação concluída!).
Abra o seu Google Cloud projeto para ver os resultados. Na Google Cloud consola, navegue para os seus recursos na IU para se certificar de que o Terraform os criou ou atualizou.

Eliminar as alterações

Para eliminar as alterações, faça o seguinte:

Para desativar a proteção contra eliminação, no ficheiro de configuração do Terraform, defina o argumento deletion_protection como false.
```
deletion_protection =  "false"
```
Aplique a configuração do Terraform atualizada executando o seguinte comando e introduzindo yes no comando:
```
terraform apply
```

Remova os recursos aplicados anteriormente com a sua configuração do Terraform executando o seguinte comando e introduzindo yes no comando:
```
terraform destroy
```

REST v1

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância.
INSTANCE_NAME: o nome da instância do Cloud SQL. Se esta instância tiver o Private Service Connect ativado, os pontos finais do Private Service Connect nas redes VPC podem estabelecer ligação à mesma.

Método HTTP e URL:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 seguintes campos existem para instâncias que têm o Private Service Connect ativado:

allowedConsumerProjects: uma lista dos projetos permitidos para a instância. Pode criar pontos finais do Private Service Connect a partir de quaisquer redes VPC nestes projetos para a associação de serviços da instância.
pscEnabled: se uma instância tem o Private Service Connect ativado.
pscServiceAttachmentLink: o URI que aponta para o anexo de serviço da instância. Use este URI para criar o ponto final do Private Service Connect.
dnsName: o nome DNS da instância. Recomendamos que crie um registo DNS com este nome e o direcione para o endereço IP do ponto final do Private Service Connect. Também recomendamos que use este nome para se ligar à instância.

Para ver como criar o pedido da API REST subjacente para esta tarefa, consulte a página instances:get.

REST v1beta4

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância.
INSTANCE_NAME: o nome da instância do Cloud SQL. Se esta instância tiver o Private Service Connect ativado, os pontos finais do Private Service Connect nas redes VPC podem estabelecer ligação à mesma.

Método HTTP e URL:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

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)

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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 seguintes campos existem para instâncias que têm o Private Service Connect ativado:

allowedConsumerProjects: uma lista dos projetos permitidos para a instância. Pode criar pontos finais do Private Service Connect a partir de quaisquer redes VPC nestes projetos para a associação de serviços da instância.
pscEnabled: se uma instância tem o Private Service Connect ativado.
pscServiceAttachmentLink: o URI que aponta para o anexo de serviço da instância. Use este URI para criar o ponto final do Private Service Connect.
dnsName: o nome DNS da instância. Recomendamos que crie um registo DNS com este nome e o direcione para o endereço IP do ponto final do Private Service Connect. Também recomendamos que use este nome para se ligar à instância.

Pode ver alguns banners na parte superior a sugerir ações que pode querer realizar.

Veja o ponto final de gravação

Um ponto final de gravação é um nome de serviço de nomes de domínio (DNS) global que é resolvido automaticamente para o endereço IP da instância principal atual. Este ponto final redireciona as ligações recebidas para a nova instância principal automaticamente em caso de uma operação de comutação por falha ou comutação de uma réplica. Pode usar o ponto final de gravação numa string de ligação SQL em vez de um endereço IP. Ao usar um ponto final de gravação, pode evitar ter de fazer alterações à ligação da aplicação quando ocorre uma indisponibilidade da região.

Para mais informações sobre como usar um ponto final de escrita para se ligar a uma instância, consulte o artigo Ligue-se a uma instância através de um ponto final de escrita.

Métrica

Esta secção apresenta gráficos de utilização das principais métricas de instâncias que pode usar para monitorizar as suas instâncias. Ao trabalhar com dados de métricas, tenha em atenção os seguintes factos:

Um ponto de dados para uma métrica é uma agregação em todas as bases de dados alojadas pela instância.
Os dados são comunicados na hora local.
Os gráficos renderizados não são atualizados automaticamente. Para ver novos dados, tem de atualizar a página.
Existe um atraso de alguns minutos entre o momento em que os dados das métricas são registados e o momento em que são apresentados nos gráficos de utilização.

Para mais informações sobre as métricas apresentadas no gráfico, consulte o artigo Monitorizar instâncias do Cloud SQL.

Para ver uma lista completa das métricas do Cloud SQL fornecidas pelo Cloud Monitoring, consulte a lista de métricas do Cloud SQL.

Para mais informações sobre a utilização do Cloud Monitoring com Google Cloud, consulte a documentação do Cloud Monitoring.

Associe-se a esta instância

Na secção Estabelecer ligação a esta instância, pode encontrar os endereços IP, a rede VPC e o nome da ligação da sua instância.

Para abrir um terminal e estabelecer ligação à sua instância, clique em Estabelecer ligação através do Cloud Shell.

Para abrir um tutorial relacionado no painel direito, clique em Estabeleça ligação a partir de uma instância de VM do Compute Engine.

Para aceder a Opções de ligação, clique em Ver todos os métodos de ligação.

Para mais informações sobre como estabelecer ligação a uma instância, consulte a Vista geral da ligação.

Conta de serviço

Esta secção mostra o endereço de email da conta de serviço da instância.

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

Configuração

Esta secção mostra as definições de configuração atuais da instância.

Para alterar as definições de configuração, clique em Editar configuração.

Para mais informações sobre a edição da configuração da instância, consulte o artigo Editar uma instância.

Operações e registos

Esta secção lista as operações de instâncias recentes, como a criação de cópias de segurança.

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

Para ver as informações de registo, clique em Ver registos de erros do PostgreSQL.

Para mais informações sobre as páginas Operações e Explorador de registos, consulte o artigo Registo do Cloud SQL.

Para informações genéricas sobre o registo, consulte os artigos Ver registos e Exportar registos.

Manutenção

Esta secção mostra as definições e o agendamento de atualizações de manutenção atuais.

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

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

Para mais informações sobre a manutenção no Cloud SQL, consulte o artigo Vista geral da manutenção.

O que se segue?

Saiba mais sobre as métricas do Cloud Monitoring para o Cloud SQL.
Saiba mais acerca das definições de instâncias.
Saiba como editar uma instância.

Veja informações da instância Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Veja informações de resumo da instância

Consola

gcloud

Terraform

Aplique as alterações

Prepare o Cloud Shell

Prepare o diretório

Aplique as alterações

Eliminar as alterações

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Veja o ponto final de gravação

Métrica

Associe-se a esta instância

Conta de serviço

Configuração

Operações e registos

Manutenção

O que se segue?

Veja informações da instância