Connettiti a Cloud SQL per SQL Server dal computer locale

Scopri come eseguire il deployment di un'app di esempio sul tuo computer locale basato su Linux, macOS o Windows connesso a un'istanza SQL Server utilizzando la console Google Cloud e un'applicazione client.

Supponendo che tu completi tutti i passaggi in modo tempestivo, le risorse create in questa guida rapida in genere costano meno di un dollaro (USD).

Prima di iniziare

  1. Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.
  2. 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.

    Go to project selector

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

  4. 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.

    Go to project selector

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

  6. Verifica di disporre delle autorizzazioni necessarie per completare questa guida rapida.
  7. Abilita le API Cloud necessarie per eseguire un'app di esempio Cloud SQL sul computer locale.

    Console

    Fai clic sul pulsante Abilita API per abilitare le API richieste per questa guida rapida.

    Abilita le API

    Vengono abilitate le seguenti API:

    • API Cloud SQL Admin
    • API IAM

    gcloud

    Installa la gcloud CLI che fornisce l'accesso da riga di comando alle tue risorse Google Cloud . L'interfaccia a riga di comando gcloud viene utilizzata per eseguire i comandi gcloud CLI presentati in questa guida rapida. Tutti i comandi sono formattati per essere eseguiti in un terminale Linux/macOS o in Windows PowerShell.

    Apri il terminale ed esegui questo comando gcloud:

    gcloud services enable sqladmin.googleapis.com iam.googleapis.com

    Questo comando abilita le seguenti API:

    • API Cloud SQL Admin
    • API IAM

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare Cloud SQL dal computer locale, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto che vuoi creare e a cui vuoi connetterti:

  • Crea o elimina un'istanza, un database e un utente: Ruolo di amministratore Cloud SQL (roles/cloudsql.admin).
  • Crea o elimina un account di servizio IAM: Ruolo di amministratore service account IAM (roles/iam.serviceAccountAdmin).
  • Aggiungi o rimuovi un'associazione di policy IAM: Ruolo amministratore IAM progetto (roles/resourcemanager.projectIamAdmin).
  • Crea, gestisci e ruota le chiavi dell'account di servizio: Amministratore chiavi service account (roles/iam.serviceAccountKeyAdmin).

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Configura Cloud SQL

Per creare un'istanza Cloud SQL:

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

    Vai a Istanze Cloud SQL

  2. Seleziona la scheda SQL Server e fai clic su Crea istanza sandbox nella casella Sandbox. In alternativa, puoi fare clic su Crea istanza e completare i seguenti passaggi:
    1. Fai clic su Scegli SQL Server.
    2. Seleziona la versione Enterprise.
    3. Scegli il preset Sandbox.
  3. Se ti viene chiesto di abilitare l'API Compute, fai clic sul pulsante Abilita API.
  4. Nella sezione Instance info (Informazioni istanza), inserisci quickstart-instance come ID istanza.
  5. Inserisci una password per l'utente sqlserver. Prendi nota della password che crei, perché ti servirà in seguito.
  6. Nella sezione Scegli la disponibilità per regione e zona, seleziona l'opzione Zona singola.
  7. Fai clic su Crea istanza.

Crea un database

Console

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

    Vai a Istanze Cloud SQL

  2. Seleziona quickstart-instance.
  3. Apri la scheda Database.
  4. Fai clic su Crea database.
    1. Nella finestra di dialogo Nuovo database, inserisci quickstart_db come nome del database.
    2. Fai clic su Crea.

gcloud

Esegui il comando gcloud sql databases create per creare un database.

gcloud sql databases create quickstart_db --instance=quickstart-instance

Configura un service account

Crea e configura un Google Cloud service account con il ruolo Client Cloud SQL con le autorizzazioni per connettersi a Cloud SQL. Dopo aver creato un account di servizio, potresti dover attendere 60 secondi o più prima di utilizzarlo.

Console

Crea un account di servizio

  1. Nella console Google Cloud vai a Crea service account.
  2. Vai a Crea service account

  3. Seleziona un Google Cloud progetto.
  4. Inserisci quickstart-service-account come nome del account di servizio.
  5. (Facoltativo) Inserisci una descrizione del service account.
  6. Fai clic su Crea e continua e vai al passaggio successivo.
  7. Scegli il ruolo Client Cloud SQL da concedere al account di servizio nel progetto.
  8. Fai clic su Continua.
  9. Fai clic su Fine per completare la creazione del service account.

Crea e scarica il file della chiave del account di servizio

  1. Nella Google Cloud console, vai alla pagina Service account.
  2. Vai ad Account di servizio

  3. Seleziona un progetto.
  4. Fai clic sull'indirizzo email del account di servizio quickstart-service-account per cui vuoi creare una chiave.
  5. Fai clic sulla scheda Chiavi.
  6. Fai clic sul menu a discesa Aggiungi chiave, quindi seleziona Crea nuova chiave.
  7. In Tipo di chiave, seleziona JSON e fai clic su Crea.

Facendo clic su Crea viene scaricato un file della chiave del service account. Una volta scaricato, il file della chiave non potrà essere scaricato di nuovo.

Assicurati di archiviare il file della chiave in modo sicuro, perché può essere utilizzato per l'autenticazione come account di servizio. Puoi spostare e rinominare il file come preferisci.

gcloud

Crea un account di servizio

  1. Per creare il account di servizio, esegui il comando gcloud iam service-accounts create:
  2. gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

    Sostituisci il seguente valore:

    • DESCRIPTION: Una descrizione facoltativa del account di servizio
  3. Per concedere al tuo account di servizio il ruolo Client Cloud SQL nel tuo progetto, esegui il comando gcloud projects add-iam-policy-binding. Sostituisci PROJECT_ID con l'ID del tuo progetto Google Cloud:
    gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client"

Crea e scarica il file della chiave del account di servizio

Per utilizzare il account di servizio appena creato dal computer locale, devi disporre di un file di chiavi del account di servizio per autenticare l'applicazione di esempio come account di servizio. Per creare e scaricare il file della chiave del account di servizio, esegui il comando gcloud iam service-accounts keys create:

gcloud iam service-accounts keys create KEY_FILE --iam-account=quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com

Sostituisci i seguenti valori:

  • KEY_FILE: il percorso di un nuovo file di output per la chiave privata, ad esempio ~/sa-private-key.json.
  • PROJECT_ID: l'ID del tuo progetto Google Cloud.

Il file della chiave del account di servizio viene scaricato sul computer locale. Una volta scaricato, il file della chiave non potrà essere scaricato di nuovo.

Assicurati di archiviare il file della chiave in modo sicuro, perché chiunque può utilizzarlo per l'autenticazione come account di servizio. Puoi spostare e rinominare il file come preferisci.

Configura l'ambiente di sviluppo per il linguaggio di programmazione

Configura l'ambiente di sviluppo del tuo computer locale per il linguaggio di programmazione che preferisci.

Go

Completa i seguenti passaggi per configurare l'ambiente di sviluppo per eseguire l'app di esempio Go.

  1. Vai alla guida alla configurazione di un ambiente di sviluppo Go.
  2. Completa le istruzioni nella sezione Installa Go.

Java

Completa i seguenti passaggi per configurare l'ambiente di sviluppo per eseguire l'app di esempio Java.

  1. Vai alla guida alla configurazione di un ambiente di sviluppo Java.
  2. Completa le istruzioni nella sezione Installare un JDK (Java Development Kit).
  3. Completa le istruzioni riportate in Installare uno strumento di automazione della build per configurare Apache Maven.

Node.js

Completa i seguenti passaggi per configurare l'ambiente di sviluppo per eseguire l'app di esempio Node.js.

  1. Vai alla guida alla configurazione di un ambiente di sviluppo Node.js.
  2. Completa le istruzioni nella sezione Installazione di Node.js e npm.

Python

Completa i seguenti passaggi per configurare l'ambiente di sviluppo per eseguire l'app di esempio Python.

  1. Vai alla guida alla configurazione di un ambiente di sviluppo Python.
  2. Completa le istruzioni nella sezione Installazione di Python.

Installa Git

Installa Git, un sistema di controllo della versione open source.

Clona un'app di esempio

Clona un'app di esempio sul tuo computer locale utilizzando il comando git clone.

Go

Esegui i seguenti comandi per clonare l'app di esempio Go sul tuo computer locale e passa alla directory contenente l'app di esempio.

  1. Clona l'app di esempio.
    git clone https://github.com/GoogleCloudPlatform/golang-samples
  2. Passa alla directory contenente l'app di esempio.
    cd golang-samples/cloudsql/sqlserver/database-sql

Java

Esegui i seguenti comandi per clonare l'app di esempio Java sul tuo computer locale e passa alla directory contenente l'app di esempio.

  1. Clona l'app di esempio.
    git clone https://github.com/GoogleCloudPlatform/java-docs-samples
  2. Passa alla directory contenente l'app di esempio.
    cd java-docs-samples/cloud-sql/sqlserver/servlet

Node.js

Esegui i comandi seguenti per clonare l'app di esempio Node.js sul tuo computer locale e cambiare directory in quella contenente l'app di esempio.

  1. Clona l'app di esempio.
    git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
  2. Passa alla directory contenente l'app di esempio.
    cd nodejs-docs-samples/cloud-sql/sqlserver/mssql

Python

Esegui i comandi seguenti per clonare l'app di esempio Python sul computer locale e passa alla directory contenente l'app di esempio.

  1. Clona l'app di esempio.
    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  2. Passa alla directory contenente l'app di esempio.
    cd python-docs-samples/cloud-sql/sql-server/sqlalchemy

Configura ed esegui l'app di esempio

Configura ed esegui l'app di esempio.

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 quickstart-instance per aprire la pagina Dettagli istanza.
  3. Nella barra delle icone nella parte superiore della pagina, fai clic su Elimina.
  4. Nella finestra di dialogo Elimina istanza, digita quickstart-instance e poi fai clic su Elimina per eliminare l'istanza.

Passaggi di pulizia facoltativi

Se non utilizzi il ruolo Client Cloud SQL che hai assegnato al account di servizio quickstart-service-account, puoi rimuoverlo.

  1. Nella Google Cloud console, vai alla pagina Service account.

    Vai a IAM

  2. Fai clic sull'icona di modifica (a forma di matita) per l'account IAM denominato quickstart-service-account.
  3. Elimina il ruolo Client Cloud SQL.
  4. Fai clic su Salva.

Se non utilizzi le API attivate nell'ambito di questa guida rapida, puoi disattivarle.

  • API abilitate in questa guida rapida:
    • API Cloud SQL Admin
    • API Identity and Access Management
  1. Nella console Google Cloud , vai alla pagina API.

    Vai alle API

  2. Seleziona le API che vuoi disattivare e fai clic sul pulsante Disabilita API.

Passaggi successivi

In base alle tue esigenze, puoi scoprire di più sulla creazione di istanze Cloud SQL.

Puoi anche scoprire come creare utenti SQL Server e database per l'istanza Cloud SQL.

Per ulteriori informazioni sui prezzi, consulta la pagina Prezzi di Cloud SQL per SQL Server.

Scopri di più su:

  • Configurazione dell'istanza Cloud SQL con un indirizzo IP pubblico.
  • Configurazione dell'istanza Cloud SQL con un indirizzo IP privato.

Inoltre, puoi scoprire di più sulla connessione a un'istanza Cloud SQL da altre applicazioni Google Cloud: