Questa pagina contiene informazioni ed esempi per la connessione a un l'istanza Cloud SQL da un servizio in esecuzione nell'ambiente flessibile di App Engine.
Cloud SQL è un servizio di database completamente gestito che ti consente di configurare, gestire e amministrare i 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 più diffusi per sviluppare le tue app, App Engine si occupa del provisioning dei server e della scalabilità delle istanze di app in base alla domanda.
configura un'istanza Cloud SQL
- Abilita l'API Cloud SQL Admin nel progetto Google Cloud da cui ti connetti, se
non l'hai ancora fatto:
- Crea un cluster Cloud SQL
per un'istanza SQL Server. Ti consigliamo di scegliere Cloud SQL
località dell'istanza nella stessa regione del servizio Cloud Run per migliorare la latenza, evitare alcuni costi di networking e ridurre
e 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 le Panoramica della connessione .
Configura l'ambiente flessibile di App Engine
I passaggi per configurare l'ambiente flessibile di App Engine dipendono dal tipo di Indirizzo IP assegnato all'istanza Cloud SQL.IP pubblico (predefinito)
Per configurare l'ambiente flessibile di App Engine in modo da abilitare le connessioni a Cloud SQL istanza:
- 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 devi aggiungerne una, consulta la Pagina Configurazione IP pubblico per istruzioni.
- Ottieni INSTANCE_CONNECTION_NAME per l'istanza. Puoi trovare
nella pagina Panoramica per la tua istanza nel
Console Google Cloud. o eseguendo il comando
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
Ruoli 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 Account di servizio dell'ambiente flessibile di App Engine. L'account di servizio si trova 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:
- Aggiorna il file
app.yaml
del progetto con l'opzione che funziona meglio. Puoi utilizzare un elenco di istanze separate da virgole per specificare più opzioni contemporaneamente.Attivazione di una porta TCP
Per abilitare una porta TCP locale, aggiungi una delle seguenti opzioni al tokenapp.yaml
, a seconda che tu ti stia connettendo a uno o a uno istanze multiple:beta_settings: cloud_sql_instances: INSTANCE_CONNECTION_NAME=tcp:PORT
beta_settings: cloud_sql_instances: INSTANCE_CONNECTION_NAME_1=tcp:PORT_1,INSTANCE_CONNECTION_NAME_2=tcp:PORT_2,...
IP privato
Per connetterti all'istanza Cloud SQL tramite IP privato, Il deployment nell'ambiente flessibile di App Engine deve trovarsi nella stessa rete VPC di Cloud SQL in esecuzione in un'istanza Compute Engine. Consulta la documentazione di configurazione Impostazioni di rete per istruzioni su come specificare una rete VPC e deployment continuo.
Una volta eseguito il deployment, l'applicazione potrà connettersi direttamente utilizzando
l'indirizzo IP privato e la porta 1433
dell'istanza.
Connettiti a Cloud SQL
Dopo aver configurato l'ambiente flessibile di App Engine, puoi connetterti di Cloud SQL.
IP pubblico (predefinito)
Per i percorsi IP pubblici, l'ambiente flessibile di App Engine fornisce crittografia e si connette utilizzando il proxy di autenticazione Cloud SQL in due modi:
- Mediante socket TCP
- Tramite un connettore Cloud SQL
IP privato
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, visualizza 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 file qui .
Node.js
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza 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, visualizza il file README su GitHub.
PHP
Per visualizzare questo snippet nel contesto di un'applicazione web, visualizza il file README su GitHub.
Best practice e altre informazioni
Puoi utilizzare il proxy di autenticazione Cloud SQL durante il test la tua applicazione in locale. 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 ovviare a questo problema, ti consigliamo di utilizzare una libreria client che supporti pool di connessioni e la riconnessione automatica.
Limiti di connessione
Ogni istanza App Engine in esecuzione in un ambiente standard Non può avere più di 100 connessioni simultanee a un'istanza. Per Per le app PHP 5.5, il limite è di 60 connessioni simultanee. Questo limite si applica a ogni istanza dell'applicazione. Ciò significa che ogni istanza un'applicazione App Engine può avere così tante connessioni al database, e, man mano che scala, il numero totale di connessioni per deployment può crescere. Per ulteriori informazioni, vedi Elementi di scalabilità:
Puoi limitare il numero massimo di connessioni utilizzate per istanza utilizzando una 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 di tempo per le richieste a seconda dell'utilizzo e completamente gestito di Google Cloud. Per ulteriori informazioni, scopri come vengono gestite le istanze nell'ambiente standard di App Engine standard e flessibile ambienti cloud-native.
Limiti di quota dell'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 La quota predefinita è di 180 al minuto per utente. Le applicazioni App Engine soggetti a quote e limiti aggiuntivi, come illustrato in alla pagina Quote di App Engine.