Créer une instance

Console

1. Accédez à la page "Instances Cloud SQL" dans Google Cloud Console.

   Accéder à la page Instances Cloud SQL

2. Cliquez sur Créer une instance.
3. Dans le panneau Choisir votre moteur de base de données de la page Créer une instance, cliquez sur Choisir SQL Server.

4. Dans la section Choisir une édition Cloud SQL de la page Créer une instance SQL Server, sélectionnez l'édition Cloud SQL pour votre instance: Enterprise ou Enterprise plus.

   Pour en savoir plus sur les éditions Cloud SQL, consultez la page Présentation des éditions Cloud SQL pour SQL Server.

5. Sélectionnez le préréglage d'édition de votre instance. Pour afficher les préréglages disponibles, cliquez sur le menu Préréglage d'édition.
6. Dans la section Informations sur l'instance, sélectionnez la version de la base de données de votre instance. Pour afficher les versions disponibles, cliquez sur le menu Version de la base de données.
7. Dans le champ ID d'instance, saisissez un ID pour votre instance.

   Vous n'avez pas besoin d'indiquer l'ID du projet. Cet ajout s'effectue automatiquement le cas échéant (par exemple, dans les fichiers journaux).

8. Dans le champ Mot de passe, saisissez un mot de passe pour l'utilisateur.
9. Dans la section Sélectionner la disponibilité régionale et zonale, sélectionnez la région et la zone de votre instance.

   Placez l'instance dans la même région que les ressources qui y accèdent. La région que vous sélectionnez ne peut plus être modifiée. Dans la plupart des cas, il n'est pas nécessaire de spécifier une zone.

10. Dans la section Personnaliser votre instance, mettez à jour les paramètres de votre instance. Par exemple, vous pouvez empêcher la suppression accidentelle d'une instance.
11. Cliquez sur Créer une instance.
12. Une fois le processus d'initialisation de l'instance terminé, cliquez sur le nom de l'instance pour l'ouvrir.

gcloud

Pour en savoir plus sur l'installation et le démarrage avec gcloud CLI, consultez la page Installer gcloud CLI. Pour obtenir plus d'informations sur le démarrage de Cloud Shell, consultez la documentation Cloud Shell.

Vous devez utiliser gcloud version 243.0.0 ou ultérieure.

Pour en savoir plus sur la protection d'une instance contre les suppressions accidentelles, consultez la section Empêcher la suppression d'une instance.

1. Créez l'instance :
   Pour les instances Cloud SQL Enterprise Plus:

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

   Pour les instances Cloud SQL Enterprise:

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

   Vous n'avez pas besoin d'indiquer l'ID du projet. Cet ajout s'effectue automatiquement le cas échéant (par exemple, dans les fichiers journaux).

   Comme indiqué précédemment sur cette page, les valeurs des processeurs virtuels et de la taille de la mémoire sont limitées pour l'édition Cloud SQL Enterprise. Consultez Choisir entre l'édition Cloud SQL Enterprise Plus et l'édition Cloud SQL Enterprise.

   Par exemple, la chaîne suivante crée une instance comportant deux processeurs virtuels et 7 680 Mo de mémoire :

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

   Pour obtenir des exemples de valeurs, consultez la section Exemples de types de machines.

   Pour en savoir plus sur les réglages des paramètres d'instance, consultez la documentation sur la commande gcloud sql instances create.

2. Notez l'adresse IP attribuée automatiquement.

   Si vous ne vous servez pas du proxy d'authentification Cloud SQL, les applications ou les outils l'utiliseront comme adresse hôte pour se connecter à l'instance.

3. Définissez le mot de passe de l'utilisateur :

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

Terraform

Pour créer une instance, utilisez une ressource 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. Créer l'instance

Tous les champs possibles ne sont pas affichés dans l'appel d'API de base ci-dessous. Pour obtenir un prototype de requête JSON, consultez la section Paramètres.

Consultez également la page Instances:insert. Pour en savoir plus sur les paramètres des instances, y compris sur les valeurs valides pour les régions, consultez la page Paramètres des instances. Pour en savoir plus sur les types de machines, consultez la section Configurations d'instances personnalisées.

N'incluez pas d'informations personnelles ou sensibles dans instance-id, car les utilisateurs externes peuvent voir cette valeur.

Vous n'avez pas besoin d'indiquer l'ID du projet dans le nom de l'instance. Cet ajout s'effectue automatiquement le cas échéant (par exemple, dans les fichiers journaux).

Le champ collation (non affiché dans l'appel d'API de base ci-dessous) vous permet de définir une valeur par défaut pour le type de classement utilisé pour les bases de données de votre instance. Cette valeur de classement par défaut est permanente au niveau de l'instance, mais pas au niveau de la base de données. Vous pouvez modifier cette valeur par défaut à l'aide d'un outil d'administration de bases de données, mais seulement pour une base de données spécifique que vous créez ou mettez à jour. Vous ne pouvez pas modifier la valeur de classement par défaut d'une instance après la création de celle-ci (sauf si vous recréez l'instance). Pour plus d'informations sur les classements dans SQL Server, consultez la page Prise en charge d’Unicode et des classements. Pour obtenir un prototype de requête JSON, consultez la section Paramètres. Voici un exemple de chaîne que vous pouvez spécifier pour le paramètre collation : SQL_Latin1_General_CP1_CI_AS.

Le champ timeZone (non affiché dans l'appel d'API de base ci-dessous) vous permet de définir un fuseau horaire pour une instance. Une fois que vous avez créé une instance, vous pouvez modifier son fuseau horaire. Pour en savoir plus et obtenir la liste des chaînes acceptées, consultez la section Paramètres. Voici un exemple de chaîne que vous pouvez spécifier pour le paramètre timeZone : "Pacific Standard Time". En savoir plus

Pour créer une instance avec service Microsoft AD géré, spécifiez un domaine tel que subdomain.mydomain.com dans le champ domain. Pour en savoir plus, consultez la page Créer une instance avec l'authentification Windows. Notez également les procédures et les contraintes liées à l'intégration d'un domaine AD géré dans un projet différent.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet.
• INSTANCE_ID : ID de l'instance.
• REGION: nom de la région.
• DATABASE_VERSION: chaîne d'énumération de la version de base de données. Exemple : SQLSERVER_2017_STANDARD.
• PASSWORD: mot de passe de l'utilisateur root.
• MACHINE_TYPE: chaîne d'énumération du type de machine (niveau). Par exemple:
  db-perf-optimized-N-4.
• EDITION_TYPE: votre édition Cloud SQL. La valeur par défaut est ENTERPRISE.
• DATA_CACHE_ENABLED (facultatif) : pour activer le cache de données pour votre instance, définissez la valeur de ce paramètre sur true.

Méthode HTTP et URL :

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

Corps JSON de la requête :

{
  "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
    },
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

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

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "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"
}

Une fois l'instance créée, vous pouvez affiner la configuration du compte utilisateur par défaut.

2. Récupérer l'adresse IPv4 de l'instance

Si vous le souhaitez, vous pouvez récupérer l'adresse IPv4 attribuée automatiquement. Dans la réponse, cette adresse se trouve dans le champ ipAddress.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet.
• INSTANCE_ID: ID de votre instance, créé à l'étape précédente

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

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

Vous devriez recevoir une réponse JSON de ce type :

{
  "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": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "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. Créer l'instance

Tous les champs possibles ne sont pas affichés dans l'appel d'API de base ci-dessous. Pour obtenir un prototype de requête JSON, consultez la section Paramètres.

Consultez également la page Instances:insert. Pour en savoir plus sur les paramètres des instances, y compris sur les valeurs valides pour les régions, consultez la page Paramètres des instances. Pour en savoir plus sur les types de machines, consultez la section Configurations d'instances personnalisées.

N'incluez pas d'informations personnelles ou sensibles dans instance-id, car les utilisateurs externes peuvent voir cette valeur.

Vous n'avez pas besoin d'indiquer l'ID du projet dans le nom de l'instance. Cet ajout s'effectue automatiquement le cas échéant (par exemple, dans les fichiers journaux).

Le champ collation (non affiché dans l'appel d'API de base ci-dessous) vous permet de définir une valeur par défaut pour le type de classement utilisé pour les bases de données de votre instance. Cette valeur de classement par défaut est permanente au niveau de l'instance, mais pas au niveau de la base de données. Vous pouvez modifier cette valeur par défaut à l'aide d'un outil d'administration de bases de données, mais seulement pour une base de données spécifique que vous créez ou mettez à jour. Vous ne pouvez pas modifier la valeur de classement par défaut d'une instance après la création de celle-ci (sauf si vous recréez l'instance). Pour plus d'informations sur les classements dans SQL Server, consultez la page Prise en charge d’Unicode et des classements. Pour obtenir un prototype de requête JSON, consultez la section Paramètres. Voici un exemple de chaîne que vous pouvez spécifier pour le paramètre collation : SQL_Latin1_General_CP1_CI_AS.

Le champ timeZone (non affiché dans l'appel d'API de base ci-dessous) vous permet de définir un fuseau horaire pour une instance. Une fois que vous avez créé une instance, vous pouvez modifier son fuseau horaire. Pour en savoir plus et obtenir la liste des chaînes acceptées, consultez la section Paramètres. Voici un exemple de chaîne que vous pouvez spécifier pour le paramètre timeZone : "Pacific Standard Time". En savoir plus

Pour créer une instance avec service Microsoft AD géré, spécifiez un domaine tel que subdomain.mydomain.com dans le champ domain. Pour en savoir plus, consultez la page Créer une instance avec l'authentification Windows. Notez également les procédures et les contraintes liées à l'intégration d'un domaine AD géré dans un projet différent.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet.
• INSTANCE_ID : ID de l'instance.
• REGION: nom de la région.
• DATABASE_VERSION: chaîne d'énumération de la version de base de données.
• MACHINE_TYPE: chaîne d'énumération du type de machine (niveau). Par exemple:
  db-perf-optimized-N-4.
• PASSWORD: mot de passe de l'utilisateur root.
• MACHINE_TYPE: chaîne d'énumération du type (niveau) de machine, comme suit : db-custom-[CPUS]-[MEMORY_MBS].
• EDITION_TYPE: votre édition Cloud SQL. La valeur par défaut est ENTERPRISE.
• DATA_CACHE_ENABLED (facultatif) : pour activer le cache de données pour votre instance, définissez la valeur de ce paramètre sur true.

Méthode HTTP et URL :

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

Corps JSON de la requête :

{
  "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
    },
  }
}

Pour envoyer votre requête, développez l'une des options suivantes :

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

Vous devriez recevoir une réponse JSON de ce type :

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "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"
}

Une fois l'instance créée, vous pouvez affiner la configuration du compte utilisateur par défaut.

2. Récupérer l'adresse IPv4 de l'instance

Si vous le souhaitez, vous pouvez récupérer l'adresse IPv4 attribuée automatiquement. Dans la réponse, cette adresse se trouve dans le champ ipAddress.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

• PROJECT_ID : ID de votre projet.
• INSTANCE_ID: ID de votre instance, créé à l'étape précédente

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

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

Vous devriez recevoir une réponse JSON de ce type :

{
  "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": "redacted@gcp-sa-cloud-sql.iam.gserviceaccount.com",
  "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"
}