Resolver problemas

Verifique se a sua pergunta ou problema já foi abordado numa das seguintes páginas:

Os tópicos nesta página incluem:

Cópia de segurança e recuperação

Problema Resolução de problemas
Não pode ver o estado da operação atual. A consola Google Cloud apenas comunica o êxito ou a falha quando a operação estiver concluída. Não foi concebido para mostrar avisos ou outras atualizações.

Execute o comando gcloud sql operations list para listar todas as operações da instância do Cloud SQL especificada.
Quer saber quem emitiu uma operação de cópia de segurança a pedido. A interface do utilizador não mostra o utilizador que iniciou uma operação.

Procure nos registos e filtre por texto para encontrar o utilizador. Pode ter de usar registos de auditoria para informações privadas. Os ficheiros de registo relevantes incluem:

  • cloudsql.googleapis.com/sqlagent.out
  • cloudsql.googleapis.com/sqlserver.err
  • Se os registos de auditoria do Google Cloud estiverem ativados e tiver as autorizações necessárias para os ver, o cloudaudit.googleapis.com/activity também pode estar disponível.
Depois de eliminar uma instância, não pode fazer uma cópia de segurança da mesma.

Se eliminar uma instância sem fazer uma cópia de segurança final dos dados, não é possível recuperar os dados. No entanto, se restaurar a instância, o Cloud SQL também restaura as cópias de segurança. Para mais informações sobre a recuperação de uma instância eliminada, consulte o artigo Mantenha as cópias de segurança após a eliminação da instância.

Se tiver feito uma operação de exportação, crie uma nova instância e, em seguida, faça uma operação de importação para recriar a base de dados. As exportações são escritas no Cloud Storage e as importações são lidas a partir daí.
Uma cópia de segurança automática está bloqueada há muitas horas e não pode ser cancelada. As cópias de segurança podem demorar muito tempo, consoante o tamanho da base de dados.

Se realmente precisar de cancelar a operação, pode pedir ao apoio ao cliente que force restart a instância.
Uma operação de restauro pode falhar quando um ou mais utilizadores referenciados no ficheiro de captura SQL não existem. Antes de restaurar uma captura de SQL, todos os utilizadores da base de dados que tenham objetos ou aos quais foram concedidas autorizações relativamente a objetos na base de dados capturada têm de existir na base de dados de destino. Caso contrário, a operação de restauro não consegue recriar os objetos com a propriedade ou as autorizações originais.

Crie os utilizadores da base de dados antes de restaurar o despejo SQL.
Quiser aumentar o número de dias durante os quais pode manter as cópias de segurança automáticas de sete para 30 dias ou mais. Pode configurar o número de cópias de segurança automáticas a reter, mas não pode reter menos do que o valor predefinido (sete). As cópias de segurança automáticas são reduzidas regularmente com base no valor de retenção configurado. Infelizmente, isto significa que as cópias de segurança atualmente visíveis são as únicas cópias de segurança automáticas a partir das quais pode fazer o restauro.

Para manter as cópias de segurança indefinidamente, pode criar uma cópia de segurança a pedido, uma vez que não são eliminadas da mesma forma que as cópias de segurança automáticas. As cópias de segurança a pedido permanecem indefinidamente. Ou seja, permanecem até serem eliminados ou a instância à qual pertencem ser eliminada. Uma vez que esse tipo de cópia de segurança não é eliminado automaticamente, pode afetar a faturação.
Uma cópia de segurança automática falhou e não recebeu uma notificação por email. Para que o Cloud SQL lhe envie uma notificação sobre o estado da cópia de segurança, configure um alerta baseado em registos.
Não consegue restaurar a sua instância através do comando RESTORE do Transact-SQL ou do SQL Server Management Studio (SSMS). O Cloud SQL não suporta o restauro de instâncias através do SSMS. Para restaurar a sua instância, execute o comando gcloud sql import.
Não é possível eliminar uma instância quando opta por fazer uma cópia de segurança final na eliminação da instância. Quando elimina uma instância, tem de confirmar se quer fazer uma cópia de segurança final da instância antes de a eliminar. Se ativou a cópia de segurança final através da definição da instância final-backup, a seleção que fizer quando eliminar a instância tem de corresponder à configuração da instância de cópia de segurança final que definiu quando ativou a cópia de segurança final para a instância. Para mitigar este problema, faça uma das seguintes ações:
  • Defina o valor de cópia de segurança final para corresponder à configuração de cópia de segurança existente da instância.
  • Deixe o campo de cópia de segurança final vazio quando eliminar a instância. Se deixar o campo vazio, o Cloud SQL usa a configuração de cópia de segurança final definida nas definições da instância para fazer uma cópia de segurança final e definir a respetiva retenção.
Para ver a configuração final da instância de cópia de segurança da sua instância, consulte Ver informações da instância.
Não é possível criar uma instância de réplica após criar com êxito uma instância principal com a definição de cópia de segurança final. Se criar uma nova instância com a definição da instância de cópia de segurança final ativada, tem de atualizar a política da organização de cópia de segurança final para aplicar as configurações de cópia de segurança apenas à instância principal. As cópias de segurança finais não são suportadas para instâncias de réplica.
Para mais informações, consulte as políticas de organização do Cloud SQL.

Clonar

Problema Resolução de problemas
A clonagem falha com o erro constraints/sql.restrictAuthorizedNetworks. A operação de clonagem está bloqueada pela configuração Authorized Networks. Authorized Networks estão configurados para endereços IP públicos na secção Conetividade da consola, e a clonagem não é permitida devido a considerações de segurança. Google Cloud

Remova todas as entradas de Authorized Networks da instância do Cloud SQL, se possível. Caso contrário, crie uma réplica sem entradas Authorized Networks.
Mensagem de erro: Failed to create subnetwork. Couldn't find free blocks in allocated IP ranges. Please allocate new ranges for this service provider. Help Token: [help-token-id].

Está a tentar usar a Google Cloud consola para clonar uma instância com um endereço IP privado, mas não especificou o intervalo de IP alocado que quer usar, e a instância de origem não foi criada com o intervalo especificado. Como resultado, a instância clonada é criada num intervalo aleatório.

Use gcloud para clonar a instância e fornecer um valor para o parâmetro
--allocated-ip-range-name. Para mais informações, consulte o artigo Clonar uma instância com um IP privado.

Ligar

Problema Resolução de problemas
Aborted connection. O problema pode ser:
  • Instabilidade de rede.
  • Nenhuma resposta aos comandos TCP keep-alive (o cliente ou o servidor não está a responder, possivelmente sobrecarregado)
  • O tempo de vida da ligação do motor da base de dados foi excedido e o servidor termina a ligação.

As aplicações têm de tolerar falhas de rede e seguir as práticas recomendadas , como a pool de ligações e a repetição. A maioria dos agrupadores de ligações deteta estes erros sempre que possível. Caso contrário, a aplicação tem de tentar novamente ou falhar sem problemas.

Para repetir a ligação, recomendamos os seguintes métodos:

  1. Retirada exponencial. Aumente o intervalo de tempo entre cada nova tentativa de forma exponencial.
  2. Adicione também uma repetição aleatória.

A combinação destes métodos ajuda a reduzir a limitação.

Crie instâncias

Problema Resolução de problemas
Mensagem de erro: Failed to create subnetwork. Couldn't find free blocks in allocated IP ranges. Please allocate new ranges for this service provider. Não existem mais endereços disponíveis no intervalo de IP atribuído. Podem existir vários cenários possíveis:

  • O tamanho do intervalo de IP atribuído para a ligação de serviço privada é inferior a /24.
  • A dimensão do intervalo de IP atribuído para a ligação de serviço privado é demasiado pequena para o número de instâncias do Cloud SQL.
  • O requisito relativo ao tamanho do intervalo de IPs atribuído é maior se forem criadas instâncias em várias regiões. Veja a dimensão do intervalo atribuído

Para resolver este problema, pode expandir o intervalo de IPs atribuído existente ou atribuir um intervalo de IPs adicional à ligação de serviço privado. Para mais informações, consulte o artigo Atribua um intervalo de endereços IP.

Se usou a flag --allocated-ip-range-name ao criar a instância do Cloud SQL, só pode expandir o intervalo de IP especificado.

Se estiver a atribuir um novo intervalo, certifique-se de que a atribuição não se sobrepõe a nenhuma atribuição existente.

Depois de criar um novo intervalo de IPs, atualize o peering de VPC com o seguinte comando:

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com \
--ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID \
--force

Se estiver a expandir uma atribuição existente, tenha cuidado para aumentar apenas o intervalo de atribuição e não o diminuir. Por exemplo, se a atribuição original for 10.0.10.0/24, faça a nova atribuição, pelo menos, em 10.0.10.0/23.

Em geral, se começar com uma atribuição /24, diminuir a máscara em 1 para cada condição (grupo de tipos de instâncias adicional, região adicional) é uma boa regra geral. Por exemplo, se tentar criar grupos de tipos de instâncias em simultâneo na mesma atribuição, passar de /24 para /23 é suficiente.

Depois de expandir um intervalo de IP existente, atualize a interligação de VPC com o seguinte comando:

gcloud services vpc-peerings update \
--service=servicenetworking.googleapis.com \
--ranges=RESERVED_RANGE_NAME \
--network=VPC_NETWORK \
--project=PROJECT_ID
Mensagem de erro: Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID]. Tente criar novamente a instância do Cloud SQL.
Mensagem de erro: HTTPError 400: Invalid request: Incorrect Service Networking config for instance: PROJECT_ID:INSTANCE_NAME:SERVICE_NETWORKING_NOT_ENABLED.

Ative a API Service Networking através do seguinte comando e tente criar novamente a instância do Cloud SQL.

gcloud services enable servicenetworking.googleapis.com \
--project=PROJECT_ID
Mensagem de erro: Failed to create subnetwork. Required 'compute.projects.get' permission for PROJECT_ID. Quando cria uma instância com um endereço IP privado, é criada uma conta de serviço no momento através da API Service Networking. Se ativou recentemente a API Service Networking, a conta de serviço pode não ser criada e a criação da instância falha. Neste caso, tem de aguardar que a conta de serviço seja propagada por todo o sistema ou adicioná-la manualmente com as autorizações necessárias.
Mensagem de erro: More than 3 subject alternative names are not allowed. Está a tentar usar um SAN personalizado para adicionar mais de três nomes DNS ao certificado do servidor de uma instância do Cloud SQL. Não pode adicionar mais de três nomes de DNS à instância.
Mensagem de erro: Subject alternative names %s is too long. The maximum length is 253 characters. Certifique-se de que os nomes DNS que quer adicionar ao certificado do servidor de uma instância do Cloud SQL não têm mais de 253 carateres.
Mensagem de erro: Subject alternative name %s is invalid.

Verifique se os nomes DNS que quer adicionar ao certificado do servidor de uma instância do Cloud SQL cumprem os seguintes critérios:

  • Não têm carateres universais.
  • Não têm pontos finais.
  • Cumprem as especificações da RFC 1034.

Exportar

Problema Resolução de problemas
HTTP Error 409: Operation failed because another operation was already in progress. Já existe uma operação pendente para a sua instância. Só é permitida uma operação de cada vez. Experimente fazer o pedido depois de a operação atual estar concluída.
HTTP Error 403: The service account does not have the required permissions for the bucket. Certifique-se de que o contentor existe e que a conta de serviço da instância do Cloud SQL (que está a fazer a exportação) tem a função Storage Object Creator (roles/storage.objectCreator) para permitir a exportação para o contentor. Consulte as funções de IAM para o Cloud Storage.
Quer que as exportações sejam automáticas. O Cloud SQL não oferece uma forma de automatizar as exportações.

Pode criar o seu próprio sistema de exportação automatizado usando produtos como o Cloud Scheduler, o Pub/Sub e as funções do Cloud Run, semelhantes a este artigo sobre a automatização de cópias de segurança. Google Cloud

Bandeiras

Problema Resolução de problemas
Quer modificar o fuso horário de uma instância do Cloud SQL.

Para saber como atualizar o fuso horário de uma instância, consulte o artigo Definições da instância.

No Cloud SQL para SQL Server, pode usar a função AT TIME ZONE para conversões de tempo e muito mais. Para mais informações sobre esta função, consulte AT TIME ZONE (Transact-SQL).

Alta disponibilidade

Problema Resolução de problemas
Não consegue encontrar as métricas para uma comutação por falha manual. Apenas as comutações por falha automáticas são incluídas nas métricas.
Os recursos da instância do Cloud SQL (CPU e RAM) estão perto de 100% de utilização, o que faz com que a instância de alta disponibilidade fique inativa. O tamanho da máquina da instância é demasiado pequeno para a carga.

Edite a instância para atualizar para um tamanho de máquina maior e ter mais CPUs e memória.

Importar

Problema Resolução de problemas
HTTP Error 409: Operation failed because another operation was already in progress. Já existe uma operação pendente para a sua instância. Só é permitida uma operação de cada vez. Experimente fazer o pedido depois de a operação atual estar concluída.
A operação de importação está a demorar demasiado tempo. Demasiadas associações ativas podem interferir com as operações de importação.

Feche operações não usadas. Verifique a utilização de memória e CPU da sua instância do Cloud SQL para se certificar de que existem muitos recursos disponíveis. A melhor forma de garantir o máximo de recursos para a importação é reiniciar a instância antes de começar a operação.

Um reinício:

  • Fecha todas as ligações.
  • Termina todas as tarefas que possam estar a consumir recursos.
Uma operação de importação pode falhar quando um ou mais utilizadores referenciados no ficheiro de captura não existem. Antes de importar um ficheiro de captura, todos os utilizadores de bases de dados que tenham objetos, ou aos quais foram concedidas autorizações relativamente a objetos na base de dados capturada, têm de existir na base de dados de destino. Caso contrário, a operação de importação não consegue recriar os objetos com a propriedade ou as autorizações originais.

Crie os utilizadores da base de dados antes da importação.
LSN sem correspondência A ordem da importação das cópias de segurança do registo de transações está incorreta ou a cadeia do registo de transações está danificada.
Importe as cópias de segurança do registo de transações pela mesma ordem que na tabela do conjunto de cópias de segurança.
StopAt demasiado cedo Este erro indica que o primeiro registo no ficheiro de registo de transações ocorre após a data/hora StopAt. Por exemplo, se o primeiro registo no ficheiro de registo de transações for 2023-09-01T12:00:00 e o campo StopAt tiver o valor 2023-09-01T11:00:00, o Cloud SQL devolve este erro.
Certifique-se de que usa a data/hora StopAt correta e o ficheiro de registo de transações correto.

Servidores associados

Mensagem de erro Resolução de problemas
Msg 7411, Level 16, State 1, Line 25

Server 'LINKED_SERVER_NAME' is not configured for DATA ACCESS. 		A opção DataAccess está desativada. Execute o seguinte comando para ativar o acesso aos dados:
EXEC sp_serveroption
    @server='LINKED_SERVER_NAME',
    @optname='data access',
    @optvalue='TRUE'

Substitua LINKED_SERVER_NAME pelo nome do servidor associado.

Access to the remote server is denied because no login-mapping exists. (Microsoft SQL Server, Error: 7416) Se tiver este problema ao estabelecer uma ligação encriptada, tem de tentar outra forma de fornecer o ID do utilizador quando aceder ao servidor associado. Para o fazer, execute o seguinte comando: 
EXEC master.dbo.sp_addlinkedserver
   @server = N'LINKED_SERVER_NAME',
   @srvproduct= N'',
   @provider= N'SQLNCLI',
   @datasrc= N'TARGET_SERVER_ID',
   @provstr= N'Encrypt=yes;TrustServerCertificate=yes;User ID=USER_ID'

Substitua o seguinte:

  • LINKED_SERVER_NAME com o nome do servidor associado.
  • TARGET_SERVER_ID com o nome do servidor de destino ou o endereço IP e o número da porta do servidor de destino.
  • USER_ID com o utilizador a iniciar sessão.

Registo

Problema Resolução de problemas
Não foram encontrados registos de auditoria. Os registos de acesso a dados só são escritos se a operação for uma chamada de API autenticada orientada pelo utilizador que cria, modifica ou lê dados criados pelo utilizador, ou se a operação aceder a ficheiros de configuração ou metadados de recursos.
As informações das operações não são encontradas nos registos. Quiser encontrar mais informações sobre uma operação.

Por exemplo, um utilizador foi eliminado, mas não consegue saber quem o fez. Os registos mostram que a operação foi iniciada, mas não fornecem mais informações. Tem de ativar o registo de auditoria para que informações de identificação pessoal (PII) detalhadas e pessoais como estas sejam registadas.
Alguns registos são filtrados do registo error.log de uma instância do Cloud SQL para SQL Server. Os registos filtrados incluem: Registos de anúncios sem indicações de tempo e incluem: Login failed for user 'x'. Reason: Token-based server access validation failed with an infrastructure error. Login lacks connect endpoint permission. [CLIENT: 127.0.0.1]. Estes registos são filtrados porque podem causar confusão.
Os ficheiros de registo são difíceis de ler. Prefere ver os registos como JSON ou texto.Pode usar o comando gcloud logging read juntamente com os comandos de pós-processamento do Linux para transferir os registos.

Para transferir os registos como JSON:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d" \
> downloaded-log.json

Para transferir os registos como TEXTO:

gcloud logging read \
"resource.type=cloudsql_database \
AND logName=projects/PROJECT_ID \
/logs/cloudsql.googleapis.com%2FLOG_NAME" \
--format json \
--project=PROJECT_ID \
--freshness="1d"| jq -rnc --stream 'fromstream(1|truncate_stream(inputs)) \
| .textPayload' \
--order=asc
> downloaded-log.txt

Faça a gestão de instâncias

Problema Resolução de problemas
O armazenamento temporário aumentou o armazenamento automático. O armazenamento automático está ativado.

O reinício elimina os ficheiros temporários, mas não reduz o armazenamento. Apenas o apoio ao cliente pode repor o tamanho da instância.
Os dados estão a ser eliminados automaticamente. É muito provável que um script esteja a ser executado em algum lugar no seu ambiente.

Procure nos registos a hora da eliminação e verifique se existe um script malicioso em execução a partir de um painel de controlo ou de outro processo automatizado.
Não é possível eliminar a instância. Pode ver a mensagem de erro ERROR: (gcloud.sql.instances.delete) HTTP Error 409: The instance or operation is not in an appropriate state to handle the request ou a instância pode ter o estado de flag INSTANCE_RISKY_FLAG_CONFIG.

Algumas explicações possíveis incluem:

  • Está em curso outra operação. As operações do Cloud SQL não são executadas em simultâneo. Aguarde pela conclusão da outra operação.
  • O aviso INSTANCE_RISKY_FLAG_CONFIG é acionado sempre que estiver a ser usada, pelo menos, uma flag beta. Remova as definições de sinalização de risco e reinicie a instância
A instância está bloqueada devido ao grande tamanho dos dados temporários. O sistema pode criar muitas tabelas temporárias em simultâneo, consoante as consultas e o carregamento.

Infelizmente, não pode reduzir o tamanho do ficheiro ibtmp1 por nenhum método, exceto reiniciando o serviço.

Uma opção de mitigação é criar a tabela temporária com ROW_FORMAT=COMPRESSED, para que seja armazenada em espaços de tabelas de ficheiros por tabela no diretório de ficheiros temporários. No entanto, a desvantagem são os custos de desempenho associados à criação e remoção de um tablespace de ficheiro por tabela para cada tabela temporária.
Erro fatal durante a atualização. Os registos podem revelar mais informações, mas, em qualquer caso, pode ser necessário o apoio ao cliente para forçar a recriação da instância.
A instância está bloqueada no reinício após ficar sem espaço em disco. A capacidade de aumento automático do armazenamento não está ativada.

Se a sua instância ficar sem armazenamento e a capacidade de aumento automático do armazenamento não estiver ativada, a instância fica offline. Para evitar este problema, pode editar a instância para ativar o aumento automático do armazenamento.
A sua instância principal no local está bloqueada. Google Cloud não pode ajudar com instâncias que não estejam no Cloud SQL.
Encerramento lento no reinício. Quando uma instância é encerrada, todas as ligações pendentes que não terminarem no prazo de 60 segundos tornam o encerramento incorreto.

Ao ter ligações com uma duração inferior a 60 segundos, é possível evitar a maioria dos encerramentos não limpos, incluindo ligações a partir da linha de comandos da base de dados. Se mantiver estas ligações abertas durante horas ou dias, os encerramentos podem não ser limpos.
Não é possível eliminar um utilizador. O utilizador tem provavelmente objetos na base de dados que dependem do mesmo. Tem de largar esses objetos ou reatribuí-los a outro utilizador.

Descubra que objetos dependem do utilizador e, em seguida, elimine ou reatribua esses objetos a outro utilizador.

Esta discussão no Stack Exchange explica como encontrar os objetos pertencentes ao utilizador.
Consultas específicas estão a ser executadas lentamente. As consultas podem ser lentas por vários motivos, principalmente devido a aspetos específicos da base de dados. Um dos motivos que pode envolver o Cloud SQL é a latência da rede, quando o recurso de origem (gravador ou leitor) e o recurso de destino (Cloud SQL) estão em regiões diferentes.

Consulte, em particular, as dicas de desempenho geral.

Para inserções, atualizações ou eliminações lentas na base de dados, considere as seguintes ações:

  • Verifique as localizações do escritor e da base de dados. O envio de dados a uma longa distância introduz latência.
  • Verifique a localização do leitor e da base de dados. A latência afeta o desempenho de leitura ainda mais do que o desempenho de escrita

Para reduzir a latência, recomendamos que localize os recursos de origem e de destino na mesma região.
É indicado que a memória está esgotada, mas os gráficos de monitorização não o mostram. Uma instância pode falhar e comunicar Out of memory, mas a consola ou os gráficos do Cloud Monitoring parecem mostrar que ainda existe memória disponível. Google Cloud

Existem outros fatores, além da sua carga de trabalho, que podem afetar a utilização de memória, como o número de ligações ativas e os processos internos gerais. Estas nem sempre se refletem nos gráficos de monitorização.

Certifique-se de que a instância tem sobrecarga suficiente para ter em conta a sua carga de trabalho, além de alguma sobrecarga adicional.
Recuperar uma instância eliminada. Todos os dados numa instância, incluindo as cópias de segurança, são perdidos permanentemente quando essa instância é eliminada.

Para preservar os seus dados, exporte-os para o Cloud Storage antes de eliminar uma instância.

A função de administrador do Cloud SQL inclui a autorização para eliminar a instância. Para evitar a eliminação acidental, conceda esta função apenas quando necessário.
Quer mudar o nome de uma instância do Cloud SQL existente. A mudança do nome de uma instância existente não é suportada.

Existem outras formas de atingir o objetivo criando uma nova instância.

  • Pode clonar a instância que quer mudar o nome e definir um novo nome para a instância clonada. Isto permite-lhe criar a nova instância sem ter de importar dados manualmente. Tal como quando cria uma nova instância, a instância clonada tem um novo endereço IP.
  • Pode exportar dados da sua instância para um contentor do Cloud Storage, criar uma nova instância com o novo nome pretendido e, em seguida, importar os dados para a nova instância.

Em ambos os casos, pode eliminar a instância antiga após a conclusão da operação. Recomendamos que opte pela clonagem, uma vez que não tem impacto no desempenho e não requer que refaça as definições de configuração da instância, como flags, tipo de máquina, tamanho do armazenamento e memória.
Erro ao eliminar uma instância. Se a proteção contra eliminação estiver ativada para uma instância, confirme os seus planos para eliminar a instância. Em seguida, desative a proteção contra eliminação antes de eliminar a instância.

Private Service Connect
Problema Resolução de problemas
A associação do serviço da instância não aceita o ponto final do Private Service Connect.
  1. Verifique o estado do ponto final.

    gcloud

    Para verificar o estado, use o comando
    gcloud compute forwarding-rules describe.

    gcloud compute forwarding-rules describe ENDPOINT_NAME \
--project=PROJECT_ID \
--region=REGION_NAME \
| grep pscConnectionStatus

    Faça as seguintes substituições:

    • ENDPOINT_NAME: o nome do ponto final
    • PROJECT_ID: o ID ou o número do projeto do projeto Google Cloud que contém o ponto final
    • REGION_NAME: o nome da região do ponto final

    REST

    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 projeto Google Cloud que contém o ponto final do Private Service Connect
    • REGION_NAME: o nome da região
    • ENDPOINT_NAME: o nome do ponto final

    Método HTTP e URL: 

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME

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

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "kind": "compute#forwardingRule",
  "id": "ENDPOINT_ID",
  "creationTimestamp": "2024-05-09T12:03:21.383-07:00",
  "name": "ENDPOINT_NAME",
  "region": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME",
  "IPAddress": "IP_ADDRESS",
  "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/serviceAttachments/SERVICE_ATTACHMENT_NAME",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION_NAME/forwardingRules/ENDPOINT_NAME",
  "network": "https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/default",
  "serviceDirectoryRegistrations": [
    {
      "namespace": "goog-psc-default"
    }
  ],
  "networkTier": "PREMIUM",
  "labelFingerprint": "LABEL_FINGERPRINT_ID",
  "fingerprint": "FINGERPRINT_ID",
  "pscConnectionId": "CONNECTION_ID",
  "pscConnectionStatus": "ACCEPTED",
  "allowPscGlobalAccess": true
}
  2. Verifique se o estado do ponto final é ACCEPTED. Se o estado for PENDING, a instância não está a permitir o projeto Google Cloud que contém o ponto final. Certifique-se de que o projeto de rede no qual o ponto final é criado é permitido. Para mais informações, consulte o artigo Edite uma instância com o Private Service Connect ativado.
ERROR: (gcloud.compute.forwarding-rules.create) Could not fetch resource: The resource 'projects/PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME' was not found Esta mensagem de erro pode ocorrer quando reserva um endereço IP interno estático para o ponto final do Private Service Connect. Certifique-se de que a sub-rede especificada existe no projeto especificado pelo URI. Se quiser criar um ponto final num projeto de serviço, mas usar uma sub-rede de uma rede de VPC partilhada, tem de especificar a sub-rede pelo respetivo URI e usar o ID do projeto do projeto anfitrião no URI. Para mais informações, consulte o artigo Crie o ponto final manualmente.
ERROR: (gcloud.compute.forwarding-rules.create) Could not fetch resource: - The resource 'projects/PROJECT_ID/global/networks/NETWORK_NAME' was not found Esta mensagem de erro pode ocorrer quando cria um ponto final do Private Service Connect manualmente. Certifique-se de que a rede especificada existe no projeto especificado pelo URI. Se quiser criar um ponto final num projeto de serviço, mas usar uma rede de VPC partilhada, tem de especificar a rede pelo respetivo URI e usar o ID do projeto do projeto anfitrião no URI. Para mais informações, consulte o artigo Crie o ponto final manualmente.
Invalid consumer network status for PSC auto connection.

A rede de consumo não está configurada corretamente ou não está configurada de todo e, por isso, não está disponível nenhum ponto final para estabelecer ligação. Para se ligar ao ponto final, tem de verificar o estado do ponto final e corrigir o erro antes de tentar estabelecer ligação novamente.
Para verificar o estado de um ponto final, consulte Obtenha o ponto final. O estado do ponto final pode ser um dos seguintes:

  • CONNECTION_POLICY_MISSING: não existe uma política de ligação de serviço correspondente na rede do consumidor. As políticas de ligação de serviços são configuradas por rede e por região. Para reconfigurar a rede, consulte o artigo Atualize uma política de ligação de serviço.
  • CONSUMER_INSTANCE_PROJECT_NOT_ALLOWLISTED: existe uma política de ligação de serviço correspondente, mas a instância de serviço não está configurada para permitir a ligação a esta instância. Para reconfigurar a política de ligação de serviços, consulte o artigo Atualize uma política de ligação de serviços.
  • POLICY_LIMIT_REACHED: a política de ligação de serviço atingiu o respetivo limite de pontos finais. Para resolver o problema, tem de aumentar o limite de pontos finais atualizando a política de ligação ao serviço.

No permission to create a service connection policy.

Não tem as autorizações necessárias para criar uma política de ligação de serviço. Para criar uma política de ligação de serviço, precisa da função Compute Network Admin IAM. Para mais informações, consulte o artigo Funções e autorizações.

A associação da rede não consegue aceitar ligações da interface do Private Service Connect quando usa a conetividade de saída do Private Service Connect.

Se a sua rede externa não conseguir aceitar ligações da interface do Private Service Connect, as políticas de ligação na associação da rede podem não estar configuradas corretamente.

Os anexos de rede têm de ser configurados para aceitar todas as ligações automaticamente ou configurados manualmente com uma lista de ligações aceites. Para mais informações, consulte as políticas de ligação.

Use o seguinte comando para validar as associações aceites no anexo de rede:

      gcloud compute network-attachments describe default
      --region=REGION_ID
 Se a interface do Private Service Connect não estiver na lista aceite, atualize a associação da rede. Para mais informações, consulte o artigo Faça a gestão dos anexos de rede.

Replicação

Problema Resolução de problemas
A réplica de leitura não começou a ser replicada na criação. Provavelmente, existe um erro mais específico nos ficheiros de registo. Inspeccione os registos nos Registos na nuvem para encontrar o erro real.
Não é possível criar uma réplica de leitura: erro invalidFlagValue. Uma das flags no pedido é inválida. Pode ser uma flag que forneceu explicitamente ou uma que foi definida para um valor predefinido.

Primeiro, verifique se o valor da flag max_connections é superior ou igual ao valor no registo principal.

Se a flag max_connections estiver definida corretamente, inspecione os registos no Cloud Logging para encontrar o erro real.
Não é possível criar uma réplica de leitura: erro desconhecido. Provavelmente, existe um erro mais específico nos ficheiros de registo. Inspeccione os registos nos Registos na nuvem para encontrar o erro real.

Se o erro for: set Service Networking service account as servicenetworking.serviceAgent role on consumer project, desative e reative o Service Networking API. Esta ação cria a conta de serviço necessária para continuar com o processo.
O disco está cheio. O tamanho do disco da instância principal pode ficar cheio durante a criação da réplica. Edite a instância principal para a atualizar para um tamanho de disco maior.
A instância da réplica está a usar demasiada memória. A réplica usa memória temporária para colocar em cache operações de leitura pedidas com frequência, o que pode fazer com que use mais memória do que a instância principal.

Reinicie a instância da réplica para recuperar o espaço de memória temporário.
A replicação foi interrompida. O limite máximo de armazenamento foi atingido e o aumento automático do armazenamento não está ativado.

Edite a instância para ativar a autorização automatic storage increase.
O atraso de replicação é consistentemente elevado. A carga de escrita é demasiado elevada para a réplica processar. O atraso de replicação ocorre quando o segmento SQL numa réplica não consegue acompanhar o segmento de E/S. Alguns tipos de consultas ou cargas de trabalho podem causar um atraso de replicação elevado temporário ou permanente para um determinado esquema. Algumas das causas típicas do atraso na replicação são:
  • Consultas lentas na réplica. Encontre-os e corrija-os.
  • As consultas como DELETE ... WHERE field < 50000000 causam um atraso na replicação com a replicação baseada em linhas, uma vez que um grande número de atualizações é acumulado na réplica.

Algumas soluções possíveis incluem:

  • Edite a instância para aumentar o tamanho da réplica.
  • Reduza a carga na base de dados.
  • Envie tráfego de leitura para a réplica de leitura.
  • Indexe as tabelas.
  • Identifique e corrija consultas de escrita lentas.
  • Recrie a réplica.
A criação de réplicas falha devido ao limite de tempo. As transações não comprometidas de longa duração na instância principal podem fazer com que a criação de réplicas de leitura falhe.

Recrie a réplica depois de parar todas as consultas em execução.