Questa pagina contiene informazioni ed esempi per la connessione a un'istanza Cloud SQL da un servizio in esecuzione nell'ambiente standard di App Engine.
Cloud SQL è un servizio di database completamente gestito che semplifica la configurazione, la gestione e l'amministrazione dei database relazionali nel cloud.
App Engine è una piattaforma serverless completamente gestita sviluppare e ospitare applicazioni web su larga scala. Puoi scegliere tra diversi linguaggi, librerie e framework di uso comune per sviluppare le tue app, poi lasciare che sia App Engine a occuparsi del provisioning dei server e della scalabilità delle istanze di app in base alla domanda.
configura un'istanza Cloud SQL
- Se non l'hai già fatto, attiva l'API Cloud SQL Admin nel progetto Google Cloud da cui ti connetti:
- Crea un cluster Cloud SQL
per un'istanza SQL Server. Ti consigliamo di scegliere una
località dell'istanza Cloud SQL nella stessa regione del servizio Cloud Run per una latenza migliore, per evitare alcuni costi di rete e per ridurre i rischi di errori tra regioni.
Per impostazione predefinita, Cloud SQL assegna un indirizzo IP pubblico a un nuovo in esecuzione in un'istanza Compute Engine. Puoi anche scegliere di assegnare un indirizzo IP privato. Per ulteriori informazioni sulle opzioni di connettività per entrambi, consulta la pagina Panoramica della connessione.
Configura l'ambiente standard di App Engine
I passaggi per configurare l'ambiente standard di App Engine dipendono dal tipo di Indirizzo IP assegnato all'istanza Cloud SQL.IP pubblico (predefinito)
L'ambiente standard di App Engine supporta la connessione a Cloud SQL per di SQL Server su IP pubblico utilizzando Connettori Go, Java e Python.
Per configurare l'ambiente standard di App Engine in modo da abilitare le connessioni a un'istanza Cloud SQL utilizzando l'IP pubblico:- Assicurati che l'istanza creata sopra abbia un indirizzo IP pubblico. Puoi verificalo nella pagina Panoramica per la tua istanza nel Console Google Cloud. Se hai bisogno di aggiungerne uno, consulta la pagina Configurazione dell'IP pubblico per istruzioni.
- Recupera l'INSTANCE_CONNECTION_NAME per la tua istanza. Puoi trovarlo nella pagina Panoramica della tua istanza nella console Google Cloud o eseguendo il seguente comando:
gcloud sql instances describe [INSTANCE_NAME]
. - Assicurati che l'account di servizio utilizzato dalla tua app per autenticare le chiamate
Cloud SQL dispone della
Ruolo Cloud SQL
e autorizzazioni.
- L'account di servizio per il tuo servizio richiede uno dei seguenti requisiti
Ruoli IAM:
Cloud SQL Client
(opzione preferita)Cloud SQL Editor
Cloud SQL Admin
cloudsql.instances.connect
cloudsql.instances.get
Per impostazione predefinita, l'app autorizzerà le connessioni utilizzando un Account di servizio App Engine. L'identità dell'account di servizio è nel formato
PROJECT_ID@appspot.gserviceaccount.com
.Se l'account di servizio di autorizzazione appartiene a un progetto diverso da quello all'istanza Cloud SQL, l'API Cloud SQL Admin e le autorizzazioni IAM verranno per entrambi i progetti.
- L'account di servizio per il tuo servizio richiede uno dei seguenti requisiti
Ruoli IAM:
IP privato
Se l'account di servizio di autorizzazione appartiene a un progetto diverso da quello una contenente l'istanza Cloud SQL, segui questi passaggi:
- In entrambi i progetti, abilita l'API Cloud SQL Admin.
- Aggiungi le autorizzazioni IAM per l'account di servizio del progetto che contiene l'istanza Cloud SQL.
- Assicurati che l'istanza Cloud SQL creata in precedenza abbia un l'indirizzo IP privato. Se devi aggiungerne uno, consulta Configurare l'IP privato per istruzioni.
- Crea un connettore di accesso VPC serverless nella stessa rete VPC dell'istanza Cloud SQL. Tieni presente le seguenti condizioni:
- A meno che non utilizzi VPC condiviso, il connettore deve trovarsi nello stesso progetto regione come risorsa che la utilizza, ma può inviare traffico alle risorse regioni diverse.
- L'accesso VPC serverless supporta la comunicazione Reti VPC connesse tramite Cloud VPN e Peering di rete VPC.
- L'accesso VPC serverless non supporta le reti legacy.
- Configura l'ambiente standard di App Engine per l'utilizzo del connettore.
- Connettiti utilizzando l'indirizzo IP privato e la porta
1433
dell'istanza.
Connettiti a Cloud SQL
Dopo aver configurato l'ambiente standard di App Engine, puoi connetterti di Cloud SQL.
IP pubblico (predefinito)
Per i percorsi IP pubblici, l'ambiente standard di App Engine fornisce crittografia e si connette usando i connettori Cloud SQL.
Connettiti con i connettori Cloud SQL
I connettori Cloud SQL sono librerie specifiche per i vari linguaggi che forniscono crittografia e autorizzazione basata su IAM quando ti connetti a un'istanza Cloud SQL.
Python
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza il file README su GitHub.
Java
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza il file README su GitHub.
Nota:
- CLOUD_SQL_CONNECTION_NAME deve essere rappresentato come <MY-PROJECT>:<INSTANCE-REGION>:<INSTANCE-NAME>
- Consulta i requisiti di versione di fabbrica del socket JDBC per pom.xml qui .
Vai
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza il file README su GitHub.
IP privato
Per i percorsi IP privati, l'applicazione si connette direttamente attraverso una rete VPC. Questo metodo utilizza TCP per connettersi direttamente a Cloud SQL senza utilizzare il proxy di autenticazione Cloud SQL.
Connetti tramite TCP
Connettiti utilizzando l'indirizzo IP privato dell'istanza Cloud SQL come host e porta 1433
.
Python
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza il file README su GitHub.
Java
Per visualizzare questo snippet nel contesto di un'applicazione web, consulta il file README su GitHub.
Nota:
- CLOUD_SQL_CONNECTION_NAME deve essere rappresentato come <MY-PROJECT>:<INSTANCE-REGION>:<INSTANCE-NAME>
- L'uso dell'argomento ipTypes=PRIVATE forzerà l'esecuzione di per la connessione all'IP privato associato a un'istanza
- Consulta i requisiti di versione di fabbrica del socket JDBC per pom.xml qui .
Node.js
Per visualizzare questo snippet nel contesto di un'applicazione web, consulta il file README su GitHub.
Vai
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza il file README su GitHub.
C#
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza il file README su GitHub.
Ruby
Per visualizzare questo snippet nel contesto di un'applicazione web, consulta il file README su GitHub.
PHP
Per visualizzare questo snippet nel contesto di un'applicazione web, consulta il file README su GitHub.
Best practice e altre informazioni
Puoi utilizzare il proxy di autenticazione Cloud SQL per testare la tua applicazione localmente. Consulta le guida rapida per l'utilizzo del proxy di autenticazione Cloud SQL per istruzioni dettagliate.
Pool di connessioni
Le connessioni ai database sottostanti potrebbero essere interrotte dal database server stesso o dall'infrastruttura sottostante. Per attenuare questo problema, ti consigliamo di utilizzare una libreria client che supporti i pool di connessioni e il ricoinvolgimento automatico.
Limiti di connessione
Ogni istanza App Engine in esecuzione nell'ambiente standard non può avere più di 100 connessioni simultanee a un'istanza. Per le app PHP 5.5, il limite è di 60 connessioni simultanee. Questo limite si applica per istanza di applicazione. Ciò significa che ogni istanza dell'applicazione App Engine può avere questo numero di connessioni al database e, in base alla scalabilità, il numero totale di connessioni per deployment può aumentare. Per ulteriori informazioni, consulta Eseguire la scalabilità degli elementi.
Puoi limitare il numero massimo di connessioni utilizzate per istanza utilizzando un pool di connessioni. Per esempi più dettagliati su come limitare il numero di connessioni, consulta le Pagina Gestione delle connessioni di database.
Le applicazioni App Engine sono soggette a limiti temporali di richiesta a seconda dell'uso e dell'ambiente. Per ulteriori informazioni, scopri come vengono gestite le istanze nell'ambiente standard di App Engine standard e flessibile ambienti cloud-native.
Limiti di quota API
App Engine fornisce un meccanismo che si connette utilizzando il proxy di autenticazione Cloud SQL, che utilizza l'API Cloud SQL Admin. I limiti di quota dell'API si applicano al proxy di autenticazione Cloud SQL. Quando l'API Cloud SQL Admin utilizza una quota di due e una media di due all'ora dopo. La quota predefinita è 180 al minuto per utente. Le applicazioni App Engine soggetti a quote e limiti aggiuntivi, come illustrato in alla pagina Quote di App Engine.