Connettiti a Cloud SQL per SQL Server utilizzando il proxy di autenticazione Cloud SQL

Connettiti a Cloud SQL per SQL Server utilizzando il proxy di autenticazione Cloud SQL

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina mostra come connetterti a Cloud SQL da un ambiente di test locale utilizzando il proxy di autenticazione Cloud SQL. Il Cloud SQL Auth Proxy fornisce accesso sicuro all'istanza Cloud SQL senza la necessità di reti autorizzate o di configurare SSL. Utilizzando il proxy di autenticazione Cloud SQL, puoi connetterti alla tua istanza Cloud SQL in modo sicuro.

Le istruzioni riportate in questa pagina sono solo per un ambiente di test e non devono essere utilizzate per gli ambienti di produzione. Per saperne di più sulla configurazione richiesta per gli ambienti di produzione, consulta Utilizza il proxy di autenticazione Cloud SQL in un ambiente di produzione e Connettiti utilizzando il proxy di autenticazione Cloud SQL.

Prima di iniziare

Nota: il nome che utilizzi per il progetto deve essere compreso tra 4 e 30 caratteri. Quando digiti il nome, il modulo suggerisce un ID progetto, che puoi modificare. L'ID progetto deve contenere da 6 a 30 caratteri, con una lettera minuscola come primo carattere. Puoi utilizzare un trattino, una lettera minuscola o una cifra per i caratteri rimanenti, ma l'ultimo carattere non può essere un trattino.

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Abilita le API Google Cloud necessarie.

   Console

   Nella console Google Cloud , vai alla pagina API.

   Vai alle API

   Abilita l'API Cloud SQL Admin.

   gcloud

   Fai clic sul seguente pulsante per aprire Cloud Shell, che fornisce l'accesso tramite riga di comando alle tue risorse Google Cloud direttamente dal browser. Cloud Shell può essere utilizzato per eseguire i comandi gcloud presentati in questa guida rapida.

   Apri Cloud Shell

   Esegui il comando gcloud services enable come segue utilizzando Cloud Shell per abilitare le API richieste per questa guida rapida:

   gcloud services enable sqladmin.googleapis.com

   Questo comando abilita le seguenti API:

   • API Cloud SQL Admin

4. Assicurati di disporre del ruolo o dei ruoli seguenti nel progetto: Amministratore Cloud SQL (roles/cloudsql.admin)

   Controlla i ruoli

   1. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM
   2. Seleziona il progetto.

   3. Nella colonna Entità, individua tutte le righe che identificano te o un gruppo di cui fai parte. Per scoprire in quali gruppi sei incluso, contatta l'amministratore.

   4. Per tutte le righe che ti specificano o ti includono, controlla la colonna Ruolo per verificare se l'elenco dei ruoli include i ruoli richiesti.

   Concedi i ruoli

   1. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM
   2. Seleziona il progetto.
   3. Fai clic su Concedi l'accesso.

   4. Nel campo Nuove entità, inserisci il tuo identificatore dell'utente. In genere si tratta dell'identificatore di un utente in un pool di identità della forza lavoro. Per maggiori dettagli, consulta Rappresenta gli utenti del pool di forza lavoro nelle policy IAM o contatta l'amministratore.

   5. Fai clic su Seleziona un ruolo, quindi cerca il ruolo.
   6. Per concedere altri ruoli, fai clic su Aggiungi un altro ruolo e aggiungi ogni ruolo successivo.
   7. Fai clic su Salva.
5. Installa e inizializza gcloud CLI.

Crea un'istanza Cloud SQL

In questa guida rapida utilizzerai la console Google Cloud . Per utilizzare gcloud CLI, curl o PowerShell, consulta Crea istanze.

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Fai clic su Crea istanza.
3. Dal menu Crea istanza, seleziona Nuova istanza.
4. Fai clic su Scegli SQL Server.
5. Nel campo ID istanza, inserisci myinstance.
6. Nel campo Password, inserisci una password per l'utente sqlserver.

7. Fai clic su Crea istanza.

   Tornerai all'elenco delle istanze. Puoi fare clic immediatamente sulla nuova istanza per visualizzarne i dettagli, ma non sarà disponibile per altre operazioni finché non viene inizializzata e avviata.

   Nota: in questo esempio, l'istanza viene creata utilizzando le impostazioni predefinite, incluso un indirizzo IP pubblico.

Debian/Ubuntu

Per Debian/Ubuntu, installa gli strumenti a riga di comando di SQL Server applicabili seguendo queste istruzioni.

CentOS/RHEL

Per CentOS/RHEL, installa gli strumenti a riga di comando di SQL Server applicabili seguendo queste istruzioni.

openSUSE

Per openSUSE, installa gli strumenti a riga di comando di SQL Server applicabili seguendo queste istruzioni.

Altre piattaforme

Consulta la pagina di destinazione per l'installazione di SQL Server, nonché la pagina di download di SQL Server.

Installa il client Cloud SQL Auth Proxy

Per l'installazione, consulta Installazione del proxy di autenticazione Cloud SQL.

Recupera il nome connessione istanza

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Fai clic sul nome dell'istanza per aprire la pagina Panoramica.
3. Nella sezione Connetti a questa istanza, copia il Nome connessione. Il nome della connessione è nel formato projectID:region:instanceID.

Avvia il proxy di autenticazione Cloud SQL

Il proxy di autenticazione Cloud SQL utilizza le Credenziali predefinite dell'applicazione (ADC) per l'autenticazione in Google Cloud. Per saperne di più, consulta Opzioni per l'autenticazione del Cloud SQL Auth Proxy.

Per autenticare il proxy di autenticazione Cloud SQL utilizzando le credenziali del tuo account utente, esegui questo comando:

gcloud auth application-default login

Avvia il proxy di autenticazione Cloud SQL nel suo terminale in modo da poterne monitorare l'output. Sostituisci INSTANCE_CONNECTION_NAME con il nome connessione dell'istanza che hai copiato nel passaggio precedente.

Per gli ambienti Linux o macOS, utilizza questo comando per avviare il proxy di autenticazione Cloud SQL:

./cloud-sql-proxy INSTANCE_CONNECTION_NAME

In PowerShell su Windows, utilizza questo comando per avviare il Cloud SQL Auth Proxy:

.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME

Viene visualizzato un messaggio simile al seguente:

Listening on 127.0.0.1:1433 for INSTANCE_CONNECTION_NAME
Ready for new connections

Esegui il seguente comando, sostituendo USER_NAME con il tuo nome utente SQL Server.

sqlcmd -S 127.0.0.1 -U USER_NAME

Torna alla finestra del terminale in cui hai avviato il proxy di autenticazione Cloud SQL. Dovresti vedere un messaggio simile al seguente:

New connection for myInstance

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

   Vai a Istanze Cloud SQL

2. Seleziona l'istanza myinstance per aprire la pagina Dettagli istanza.
3. Nella barra delle icone nella parte superiore della pagina, fai clic su Elimina.
4. Nella finestra Elimina istanza, digita il nome dell'istanza e fai clic su Elimina.

Passaggi di pulizia facoltativi

Se non utilizzi le API abilitate nell'ambito di questa guida rapida, puoi disabilitarle.

• API abilitate in questa guida rapida:
  • API Cloud SQL Admin

1. Nella console Google Cloud , vai alla pagina API.

   Vai alle API

2. Seleziona l'API Cloud SQL Admin e poi fai clic sul pulsante Disabilita API.

Passaggi successivi

• Scopri come risolvere i problemi relativi al Cloud SQL Auth Proxy.

• Scopri di più sul proxy di autenticazione Cloud SQL.