Crea un'istanza

Console

1. Vai alla pagina Istanze Cloud SQL nella console Google Cloud.

   Vai a Istanze Cloud SQL

2. Fai clic su Crea istanza.
3. Nel riquadro Scegli il motore del database della pagina Crea un'istanza, fai clic su Scegli SQL Server.

4. Nella sezione Scegli una versione di Cloud SQL della pagina Crea un'istanza SQL Server, seleziona la versione di Cloud SQL per la tua istanza: Enterprise o Enterprise plus.

   Per saperne di più sulle versioni di Cloud SQL, consulta Introduzione alle versioni di Cloud SQL per SQL Server.

5. Seleziona la versione preimpostata per l'istanza. Per vedere le disponibilità fai clic sul menu Preimpostazione edizione.
6. Nella sezione Informazioni istanza, seleziona la versione del database per l'istanza. Per visualizzare le versioni disponibili, fai clic sul menu Versione database.
7. Nel campo ID istanza, inserisci e un ID per l'istanza.

   Non è necessario includere l'ID progetto nel nome dell'istanza. L'operazione viene eseguita automaticamente appropriato (ad esempio, nei file di log).

8. Nel campo Password, inserisci una password per l'utente.
9. Nella sezione Scegli regione e disponibilità a livello di zona, seleziona la regione e la zona per la tua istanza.

   Posiziona l'istanza nella stessa regione delle risorse per accedervi. La regione selezionata non potrà essere modificata in futuro. Nella maggior parte dei casi, casi, non devi specificare una zona.

10. Nella sezione Personalizza la tua istanza, aggiorna il le impostazioni per l'istanza. Ad esempio, puoi impedire l'eliminazione accidentale dell'istanza.
11. Fai clic su Crea istanza.
12. Al termine del processo di inizializzazione dell'istanza, fai clic sul nome dell'istanza aprirlo.

gcloud

Per informazioni sull'installazione e su come iniziare a utilizzare il gcloud CLI, consulta Installazione di gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta documentazione di Cloud Shell.

Devi utilizzare gcloud versione 243.0.0 o successiva.

Per informazioni sulla protezione di un'istanza da eliminazione accidentale, vedi Impedire l'eliminazione di un'istanza.

1. Crea l'istanza:
   Per le istanze della versione Cloud SQL Enterprise Plus:

   gcloud sql instances create INSTANCE_NAME \
   --database-version=DATABASE_VERSION \
   --region=REGION \
   --zone=ZONE \
   --tier=TIER \
   --root-password=ROOT_PASSWORD
   --edition=ENTERPRISE_PLUS
   

   Per le istanze della versione Cloud SQL Enterprise:

   gcloud sql instances create INSTANCE_NAME \
   --database-version=DATABASE_VERSION \
   --region=REGION \
   --zone=ZONE \
   --cpu=NUMBER_OF_vCPUs \
   --memory=MEMORY_SIZE \
   --root-password=ROOT_PASSWORD
   --edition=ENTERPRISE
   

   Non è necessario includere l'ID progetto nel nome dell'istanza. L'operazione viene eseguita automaticamente appropriato (ad esempio, nei file di log).

   Come già detto in precedenza, i valori per vCPU e dimensione della memoria con limitazioni per la versione Cloud SQL Enterprise. Vedi Scegli tra la versione Cloud SQL Enterprise Plus e Cloud SQL Enterprise.

   Ad esempio, la stringa seguente crea un'istanza con due vCPU 7.680 MB di memoria:

   gcloud sql instances create myinstance \
   --database-version=SQLSERVER_2017_STANDARD \
   --region=us-central1 \
   --zone=us-central1-a \
   --cpu=2 \
   --memory=7680MB \
   --root-password=EXAMPLE_PASSWORD
   --edition=ENTERPRISE
   

   Per alcuni valori di esempio, consulta Esempi di tipi di macchine.

   Per saperne di più sui parametri per le impostazioni dell'istanza, consulta gcloud sql instances create.

2. Prendi nota dell'indirizzo IP assegnato automaticamente.

   Se non utilizzi il proxy di autenticazione Cloud SQL, utilizzerai questo indirizzo come l'indirizzo host che le tue applicazioni o i tuoi strumenti utilizzano per connettersi in esecuzione in un'istanza Compute Engine.

3. Imposta la password per l'utente:

   gcloud sql users set-password sqlserver no-host --instance=[INSTANCE_NAME] \
          --password=[PASSWORD]
   

Terraform

Per creare un'istanza, utilizza una risorsa Terraform.

resource "google_sql_database_instance" "instance" {
  name             = "sqlserver-instance"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

REST v1

1. Crea l'istanza

Non tutti i campi possibili vengono mostrati nella chiamata API di base riportata di seguito. Per un un prototipo di richiesta JSON, vedi Impostazioni.

Vedi anche Instances:insert. Per informazioni sulle impostazioni delle istanze, tra cui valori validi per le regioni, consulta Impostazioni istanza. Per sui tipi di macchina, consulta Configurazioni di istanze personalizzate.

Non includere informazioni sensibili o che consentono l'identificazione personale tra instance-id; il valore è visibile all'esterno.

Non è necessario includere l'ID progetto nel nome dell'istanza. L'operazione viene eseguita automaticamente appropriato (ad esempio, nei file di log).

Il campo collation (non mostrato nella chiamata API di base riportata di seguito) consente di impostare un valore predefinito tipo di regole di confronto utilizzate per i database nell'istanza. Questa regola di confronto è permanente a livello di istanza, ma non al livello a livello di database. Puoi modificare questa impostazione predefinita con un di amministrazione di database, ma solo per un database specifico creazione o aggiornamento. Non puoi modificare il valore predefinito delle regole di confronto per un'istanza dopo aver creato l'istanza (a meno che non la crei di nuovo). Per informazioni sulle regole di confronto in SQL Server, vedi Supporto delle regole di confronto e Unicode. Per un prototipo di una richiesta JSON, vedi Impostazioni. Di seguito è riportata una stringa di esempio che potresti specificare Parametro collation: SQL_Latin1_General_CP1_CI_AS.

Il campo timeZone (non mostrato nella chiamata API di base riportata di seguito) consente di impostare un fuso orario predefinito permanente per un'istanza. Per una rappresentazione JSON che include questo campo; consulta Impostazioni. Di seguito è riportata una stringa di esempio che potresti specificare Campo timeZone: "Pacific Standard Time". Scopri di più.

Per creare un'istanza integrata con Microsoft Active Directory gestito, specifica un dominio, ad esempio subdomain.mydomain.com, per domain . Per ulteriori informazioni, vedi Creazione di un'istanza con l'autenticazione di Windows. Inoltre, tieni presente procedure e vincoli per l'integrazione con un dominio AD gestito in un altro progetto.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto.
• INSTANCE_ID: l'ID istanza.
• REGION: il nome della regione.
• DATABASE_VERSION: una stringa enum della versione del database. Ad esempio: SQLSERVER_2017_STANDARD.
• PASSWORD: la password dell'utente root.
• MACHINE_TYPE: una stringa enum del tipo di macchina (livello). Ad esempio:
  db-perf-optimized-N-4.
• EDITION_TYPE: la tua versione di Cloud SQL. Il valore predefinito è ENTERPRISE.
• DATA_CACHE_ENABLED: (facoltativo) per abilitare la cache dei dati per l'istanza, imposta il valore di questo parametro su true.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances

Corpo JSON della richiesta:

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "backupConfiguration": {
      "enabled": true
    },
    "dataCacheConfig" = {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-01T19:13:21.834Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Dopo aver creato l'istanza, puoi ulteriormente configura il valore predefinito Account utente.

2. Recupera l'indirizzo IPv4 dell'istanza

Facoltativamente, puoi recuperare l'indirizzo IPv4 assegnato automaticamente. Nella risposta, l'indirizzo è nel campo ipAddress.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto
• INSTANCE_ID: l'ID istanza creato nel passaggio precedente

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "DATABASE_VERSION",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "MACHINE_TYPE",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "ZONE",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "19:00",
      "kind": "sql#backupConfiguration",
      "enabled": true
    },
    "settingsVersion": "1",
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "PROJECT_ID",
  "serviceAccountEmailAddress": "[email protected]",
  "backendType": "BACKEND_TYPE",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "connectionName": "PROJECT_ID:REGION:INSTANCE_ID",
  "name": "INSTANCE_ID",
  "region": "REGION",
  "gceZone": "ZONE"
}

REST v1beta4

1. Crea l'istanza

Non tutti i campi possibili vengono mostrati nella chiamata API di base riportata di seguito. Per un un prototipo di richiesta JSON, vedi Impostazioni.

Vedi anche Istanze:inserisci. Per informazioni sulle impostazioni delle istanze, tra cui valori validi per le regioni, consulta Impostazioni istanza. Per sui tipi di macchina, consulta Configurazioni di istanze personalizzate.

Non includere informazioni sensibili o che consentono l'identificazione personale tra instance-id; il valore è visibile all'esterno.

Non è necessario includere l'ID progetto nel nome dell'istanza. L'operazione viene eseguita automaticamente appropriato (ad esempio, nei file di log).

Il campo collation (non mostrato nella chiamata API di base riportata di seguito) consente di impostare un valore predefinito tipo di regole di confronto utilizzate per i database nell'istanza. Questa regola di confronto è permanente a livello di istanza, ma non al livello a livello di database. Puoi modificare questa impostazione predefinita con un di amministrazione di database, ma solo per un database specifico creazione o aggiornamento. Non puoi modificare il valore predefinito delle regole di confronto per un'istanza dopo aver creato l'istanza (a meno che non la crei di nuovo). Per informazioni sulle regole di confronto in SQL Server, vedi Supporto delle regole di confronto e Unicode. Per un prototipo di una richiesta JSON, vedi Impostazioni. Di seguito è riportata una stringa di esempio che potresti specificare Parametro collation: SQL_Latin1_General_CP1_CI_AS.

Il campo timeZone (non mostrato nella chiamata API di base riportata di seguito) consente di impostare un fuso orario predefinito permanente per un'istanza. Per una rappresentazione JSON che include questo campo; consulta Impostazioni. Di seguito è riportata una stringa di esempio che potresti specificare Campo timeZone: "Pacific Standard Time". Scopri di più.

Per creare un'istanza integrata con Microsoft Active Directory gestito, specifica un dominio, ad esempio subdomain.mydomain.com, per domain . Per ulteriori informazioni, vedi Creazione di un'istanza con l'autenticazione di Windows. Inoltre, tieni presente procedure e vincoli per l'integrazione con un dominio AD gestito in un altro progetto.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto.
• INSTANCE_ID: l'ID istanza.
• REGION: il nome della regione.
• DATABASE_VERSION: una stringa enum della versione del database.
• MACHINE_TYPE: una stringa enum del tipo di macchina (livello). Ad esempio:
  db-perf-optimized-N-4.
• PASSWORD: la password dell'utente root.
• MACHINE_TYPE: una stringa enum del tipo di macchina (livello), ad esempio: db-custom-[CPUS]-[MEMORY_MBS].
• EDITION_TYPE: la tua versione di Cloud SQL. Il valore predefinito è ENTERPRISE.
• DATA_CACHE_ENABLED: (facoltativo) per abilitare la cache dei dati per l'istanza, imposta il valore di questo parametro su true.

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances

Corpo JSON della richiesta:

{
  "name": "INSTANCE_ID",
  "region": "REGION",
  "databaseVersion": "DATABASE_VERSION",
  "rootPassword": "PASSWORD",
  "settings": {
    "tier": "MACHINE_TYPE",
    "edition": "EDITION_TYPE",
    "backupConfiguration": {
      "enabled": true
    },
    "dataCacheConfig" = {
      "dataCacheEnabled": DATA_CACHE_ENABLED
    },
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[email protected]",
  "insertTime": "2020-01-01T19:13:21.834Z",
  "operationType": "CREATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Dopo aver creato l'istanza, puoi ulteriormente configura il valore predefinito Account utente.

2. Recupera l'indirizzo IPv4 dell'istanza

Facoltativamente, puoi recuperare l'indirizzo IPv4 assegnato automaticamente. Nella risposta, l'indirizzo è nel campo ipAddress.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto
• INSTANCE_ID: l'ID istanza creato nel passaggio precedente

Metodo HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#instance",
  "state": "RUNNABLE",
  "databaseVersion": "DATABASE_VERSION",
  "settings": {
    "authorizedGaeApplications": [],
    "tier": "MACHINE_TYPE",
    "kind": "sql#settings",
    "pricingPlan": "PER_USE",
    "replicationType": "SYNCHRONOUS",
    "activationPolicy": "ALWAYS",
    "ipConfiguration": {
      "authorizedNetworks": [],
      "ipv4Enabled": true
    },
    "locationPreference": {
      "zone": "ZONE",
      "kind": "sql#locationPreference"
    },
    "dataDiskType": "PD_SSD",
    "backupConfiguration": {
      "startTime": "19:00",
      "kind": "sql#backupConfiguration",
      "enabled": true
    },
    "settingsVersion": "1",
    "dataDiskSizeGb": "10"
  },
  "etag": "--redacted--",
  "ipAddresses": [
    {
      "type": "PRIMARY",
      "ipAddress": "10.0.0.1"
    }
  ],
  "serverCaCert": {
    ...
  },
  "instanceType": "CLOUD_SQL_INSTANCE",
  "project": "PROJECT_ID",
  "serviceAccountEmailAddress": "[email protected]",
  "backendType": "BACKEND_TYPE",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "connectionName": "PROJECT_ID:REGION:INSTANCE_ID",
  "name": "INSTANCE_ID",
  "region": "REGION",
  "gceZone": "ZONE"
}