Questa pagina descrive come visualizzare le informazioni su un'istanza Cloud SQL.
Visualizza informazioni di riepilogo dell'istanza
Puoi visualizzare informazioni di riepilogo sulle istanze Cloud SQL utilizzando la console Google Cloud, gcloud CLI o l'API.
Console
Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.
Vengono visualizzate le seguenti informazioni sulle istanze Cloud SQL per le quali è abilitato Private Service Connect:
- Metodo di connessione interna: indica se per la connessione all'istanza viene utilizzato Private Service Connect o accesso privato ai servizi
- Indirizzo IP privato: gli indirizzi IP degli endpoint Private Service Connect nella rete VPC che si connettono al collegamento del servizio dell'istanza
- Nome DNS: il nome DNS dell'istanza
Per vedere lo stato attuale dell'istanza, tieni il puntatore sopra l'icona di stato accanto al nome di un'istanza.
Se l'istanza è nello stato
FAILED
oMAINTENANCE
, puoi recuperarla selezionando un intervallo di tempo trascorso nel passato e ripristinando lo stato dell'istanza in quel momento.Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Nella scheda Connetti a questa istanza, vengono visualizzate le seguenti informazioni aggiuntive sulle istanze Cloud SQL in cui è abilitato Private Service Connect:
- Connettività con IP privato:lo stato è Abilitata perché l'istanza deve avere un indirizzo IP interno
- Progetti consentiti: questi progetti consentono le connessioni dagli endpoint di Private Service Connect all'istanza
- Collegamento del servizio: il collegamento al servizio dell'istanza.
- Connettività con IP pubblico:lo stato è Disabilitato perché le connessioni con IP esterni non sono supportate.
per visualizzare le informazioni di connettività sull'istanza, incluse informazioni viene aggiunto all'istanza l'indirizzo IP esterno, qualsiasi rete autorizzata associati all'istanza e se altri servizi Google Cloud, come come BigQuery, possono accedere ai dati in Cloud SQL ed eseguire query su questi dati su una connessione interna, fai clic sulla scheda Connessioni.
Per ulteriori informazioni su questa scheda, vedi Informazioni sulla connessione opzioni.
Fai clic sulla scheda Networking. Vengono visualizzate le seguenti informazioni sulle istanze per le quali Private Service Connect è abilitato:
- La casella di controllo IP privato è selezionata, ma disattivata. L'istanza deve avere un indirizzo IP interno e questa impostazione non può essere modificata.
- I progetti consentiti per l'istanza.
- La casella di controllo IP pubblico è selezionata, ma disattivata.
- Il campo Reti autorizzate è disattivato perché l'istanza utilizza Private Service Connect, che non supporta questa funzionalità.
gcloud
Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installare con gcloud CLI. Per informazioni sull'avvio di Cloud Shell, Utilizzare Cloud Shell.
Per visualizzare informazioni di riepilogo su un'istanza, utilizza il comando
gcloud sql instances describe
:gcloud sql instances describe INSTANCE_NAME \ --project=PROJECT_ID
Effettua le seguenti sostituzioni:
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
Ecco un esempio dell'output per l'esecuzione di questo 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- Per visualizzare informazioni più dettagliate sulle istanze in cui è abilitato Private Service Connect, aggiungi i seguenti parametri:
Impostazione | Parametro | Note |
---|---|---|
Nome DNS | dnsName |
Il nome DNS dell'istanza. Ti consigliamo di creare un record DNS con questo nome e puntarlo all'indirizzo IP dell'endpoint Private Service Connect. Ti consigliamo inoltre di utilizzare questo nome per connetterti all'istanza. |
Collegamento servizio | pscServiceAttachmentLink |
L'URI che punta al collegamento del servizio dell'istanza. Utilizza questo URI per creare l'endpoint Private Service Connect. |
Progetti per i consumatori consentiti | allowedConsumerProjects |
Un elenco dei progetti consentiti per l'istanza. Puoi creare endpoint Private Service Connect da qualsiasi rete VPC in questi progetti al collegamento del servizio dell'istanza. |
Abilitazione di Private Service Connect in corso... | pscEnabled |
Indica se per un'istanza è abilitato Private Service Connect. |
Terraform
Per creare un'istanza, utilizza una risorsa Terraform.
Applica le modifiche
Per applicare la configurazione Terraform a un progetto Google Cloud, completa i passaggi nella le sezioni seguenti.
Prepara Cloud Shell
- Avvia Cloud Shell.
-
Imposta il progetto Google Cloud predefinito dove vuoi applicare le configurazioni Terraform.
Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
Le variabili di ambiente vengono sostituite se imposti valori espliciti in Terraform di configurazione del deployment.
Prepara la directory
Ogni file di configurazione Terraform deve avere una directory (inoltre chiamato modulo principale).
-
In Cloud Shell, crea una directory e un nuovo
all'interno di quella directory. Il nome del file deve contenere
.tf
, ad esempiomain.tf
. In questo tutorial, il file è denominatomain.tf
.mkdir DIRECTORY && cd DIRECTORY && touch main.tf
-
Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.
Copia il codice campione nel nuovo oggetto
main.tf
.Facoltativamente, copia il codice da GitHub. Opzione consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.
- Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
- Salva le modifiche.
-
Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory.
terraform init
Facoltativamente, per utilizzare la versione più recente del provider Google, includi
-upgrade
:terraform init -upgrade
Applica le modifiche
-
Rivedi la configurazione e verifica che le risorse che Terraform creerà o
che l'aggiornamento soddisfi le tue aspettative:
terraform plan
Apporta le correzioni necessarie alla configurazione.
-
Applica la configurazione Terraform eseguendo questo comando e inserendo
yes
alla richiesta:terraform apply
Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". per creare un nuovo messaggio email.
- Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud, vai alle risorse nella UI per assicurarti create o aggiornate da Terraform.
Elimina le modifiche
Per eliminare le modifiche:
- Per disabilitare la protezione dall'eliminazione, nel file di configurazione Terraform imposta la classe
Argomento
deletion_protection
perfalse
.deletion_protection = "false"
- Applica la configurazione Terraform aggiornata eseguendo il comando seguente
inserendo
yes
alla richiesta:terraform apply
-
Rimuovi le risorse applicate in precedenza con la tua configurazione Terraform eseguendo questo comando e inserendo
yes
al prompt:terraform destroy
REST v1
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "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" }
I seguenti campi esistono per le istanze per le quali Private Service Connect è abilitato:
allowedConsumerProjects
: un elenco di progetti consentiti per l'istanza. Puoi creare endpoint Private Service Connect da qualsiasi rete VPC in questi progetti al collegamento del servizio dell'istanza.pscEnabled
: indica se è abilitato Private Service Connect per un'istanza.pscServiceAttachmentLink
: l'URI che rimanda al collegamento del servizio dell'istanza. Utilizza questo URI per creare l'endpoint Private Service Connect.dnsName
: il nome DNS dell'istanza. Ti consigliamo di creare un record DNS con questo nome e puntarlo all'indirizzo IP dell'endpoint Private Service Connect. Ti consigliamo inoltre di utilizzare questo nome per connetterti all'istanza.
Per scoprire come creare la richiesta API REST sottostante per questa attività, consulta la pagina instances:get.
REST v1beta4
Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:
- PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
- INSTANCE_NAME: il nome dell'istanza Cloud SQL. Se per questa istanza è abilitato Private Service Connect, gli endpoint di Private Service Connect nelle reti VPC possono connettersi all'istanza.
Metodo HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME
Per inviare la richiesta, espandi una delle seguenti opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "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" }
I seguenti campi esistono per le istanze per le quali Private Service Connect è abilitato:
allowedConsumerProjects
: un elenco di progetti consentiti per l'istanza. Puoi creare endpoint Private Service Connect da qualsiasi rete VPC in questi progetti al collegamento di servizio dell'istanza.pscEnabled
: indica se è abilitato Private Service Connect per un'istanza.pscServiceAttachmentLink
: l'URI che rimanda al collegamento del servizio dell'istanza. Utilizza questo URI per creare l'endpoint Private Service Connect.dnsName
: il nome DNS dell'istanza. Ti consigliamo di creare un record DNS con questo nome e di indirizzarlo all'indirizzo IP dell'endpoint Private Service Connect. Ti consigliamo inoltre di utilizzare questo nome per connetterti all'istanza.
Per scoprire come creare la richiesta API REST sottostante per questa attività, consulta la pagina instances:get.
Potresti vedere alcuni banner in alto che suggeriscono azioni che che vuoi intraprendere.
Metriche
Questa sezione fornisce grafici di utilizzo delle metriche delle istanze chiave che puoi usare per per monitorare le istanze. Quando lavori con i dati delle metriche, tieni presente quanto segue tieni presente quanto segue:
- Un punto dati per una metrica è un aggregato su tutti i database ospitati dall'istanza.
- I dati vengono riportati nell'ora locale.
- I grafici visualizzati non si aggiornano automaticamente. per vedere nuovi dati, devi aggiorna la pagina.
- Si verifica un ritardo di alcuni minuti tra la registrazione dei dati delle metriche e l'ora in cui viene visualizzata nei grafici sull'utilizzo.
Per ulteriori informazioni sulle metriche mostrate nel grafico, consulta Monitoraggio delle istanze Cloud SQL.
Per un elenco completo delle metriche di Cloud SQL fornite da Cloud Monitoring, consulta l'elenco delle metriche di Cloud SQL.
Per ulteriori informazioni sull'uso di Cloud Monitoring con Google Cloud, consulta la documentazione di Cloud Monitoring.
Connetti a questa istanza
Nella sezione Connetti a questa istanza, puoi trovare Indirizzi IP, rete VPC e nome connessione.
Per aprire un terminale e connetterti all'istanza, fai clic su Connettiti utilizzando Cloud Shell.
Per aprire un tutorial correlato nel riquadro a destra, fai clic su Connettiti da un'istanza VM di Compute Engine.
Per andare a Opzioni di connessione, Fai clic su Visualizza tutti i metodi di connessione.
Per ulteriori informazioni sulla connessione a un'istanza, consulta Panoramica della connessione.
Service account
Questa sezione mostra l'indirizzo email dell'account di servizio dell'istanza.
Per ulteriori informazioni, consulta IAM account di servizio.
Configurazione
Questa sezione mostra le impostazioni di configurazione attuali dell'istanza.
Per modificare le impostazioni di configurazione, fai clic su Modifica configurazione.
Per saperne di più sulla modifica della configurazione dell'istanza, consulta modifica di un'istanza.
Operazioni e log
Questa sezione elenca le operazioni recenti dell'istanza, come la creazione di backup.
Per visualizzare le operazioni recenti, fai clic su Visualizza tutte le operazioni.
Per visualizzare le informazioni di logging, fai clic su Visualizza i log degli errori PostgreSQL.
Per ulteriori informazioni sulle pagine Operazioni ed Esplora log, consulta Logging di Cloud SQL.
Per informazioni generiche sul logging, consulta Visualizzazione dei log e Esportazione dei log.
Manutenzione
Questa sezione mostra le impostazioni e la programmazione attuali per gli aggiornamenti di manutenzione.
Per modificare le preferenze, fai clic su Modifica preferenze di manutenzione.
Per modificare le impostazioni di notifica, fai clic su Modifica preferenze di notifica.
Per saperne di più sulla manutenzione in Cloud SQL, consulta Panoramica della manutenzione.
Passaggi successivi
- Scopri di più sulle metriche di Cloud Monitoring per Cloud SQL.
- Scopri di più sulle impostazioni per le istanze.
- Scopri di più sulla modifica di un'istanza.