Créer et gérer des bases de données

MySQL | PostgreSQL | SQL Server

Cette page contient des informations décrivant comment créer, répertorier et supprimer des bases de données MySQL sur une instance Cloud SQL.

Une nouvelle instance possède quatre bases de données système :

information_schema : fournit un accès aux métadonnées de la base de données ainsi que des informations sur le serveur MySQL.
mysql : schéma système. Il contient des tables qui stockent les informations requises par le serveur MySQL lors de son exécution.
performance_schema : fonctionnalité permettant de surveiller l'exécution du serveur MySQL à un niveau inférieur.
sys : contient un ensemble d'objets qui aide les administrateurs de bases de données et les développeurs à interpréter les données collectées par le schéma de performances.

Pour en savoir plus sur les bases de données MySQL, consultez la documentation MySQL.

Avant de commencer

Avant d'effectuer les tâches indiquées sur cette page :

Créé une instance Cloud SQL. Pour en savoir plus, consultez la page Créer des instances.

Si vous prévoyez de créer ou de gérer les bases de données à l'aide du client mysql, vous devez :

configuré l'accès et vous être connecté à l'instance avec un client mysql. Pour en savoir plus sur les options de connexion, consultez la page Options de connexion pour les applications externes.

Créer une base de données sur l'instance Cloud SQL

Remarque : La longueur maximale du nom de la base de données est de 64 caractères. Pour plus d'informations sur les autres critères de ce nom, consultez la section Noms d'objet de schéma.

Si vous ne spécifiez pas de jeu de caractères ni de classement personnalisés lorsque vous créez votre base de données, celle-ci utilisera les valeurs par défaut suivantes :

MySQL 5.6, 5.7 : (créée avec la console Google Cloud, l'API Cloud SQL Admin, gcloud CLI, Terraform ou le client MySQL)

Jeu de caractères : utf8
Classement : utf8_general_ci

MySQL 8.0.x (créée avec la console Google Cloud)

Jeu de caractères : utf8
Classement : utf8_general_ci

MySQL 8.0.x (créée avec l'API Cloud SQL Admin, gcloud CLI, Terraform ou le client MySQL)

Jeu de caractères : utf8mb4
Classement : utf8mb4_0900_ai_ci

Si vous devez modifier la configuration du jeu de caractères ou du classement de votre base de données après sa création, consultez la section Mettre à jour le jeu de caractères et le classement d'une base de données.

Console

Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Dans le menu de navigation SQL, sélectionnez Bases de données.
Cliquez sur Create database.
Dans la boîte de dialogue Créer une base de données, spécifiez le nom de la base de données, et éventuellement le jeu de caractères et le classement.
Pour plus d'informations sur les jeux de caractères et les classements, consultez Jeu de caractères, classements, Unicode.
Cliquez sur Créer.

gcloud

Pour plus d'informations, consultez la page sur gcloud sql databases create.

Pour plus d'informations sur les jeux de caractères et les classements, consultez Jeu de caractères, classements, Unicode.

gcloud sql databases create DATABASE_NAME \
--instance=INSTANCE_NAME \
[--charset=CHARSET] \
[--collation=COLLATION]

Terraform

Pour créer une base de données, utilisez une ressource Terraform.

resource "google_sql_database" "database" {
  name     = "my-database"
  instance = google_sql_database_instance.instance.name
}

Appliquer les modifications

Pour appliquer votre configuration Terraform dans un projet Google Cloud, suivez les procédures des sections suivantes.

Préparer Cloud Shell

Lancez Cloud Shell.
Définissez le projet Google Cloud par défaut dans lequel vous souhaitez appliquer vos configurations Terraform.

Vous n'avez besoin d'exécuter cette commande qu'une seule fois par projet et vous pouvez l'exécuter dans n'importe quel répertoire.
```
export GOOGLE_CLOUD_PROJECT=PROJECT_ID
```
Les variables d'environnement sont remplacées si vous définissez des valeurs explicites dans le fichier de configuration Terraform.

Préparer le répertoire

Chaque fichier de configuration Terraform doit avoir son propre répertoire (également appelé module racine).

Dans Cloud Shell, créez un répertoire et un nouveau fichier dans ce répertoire. Le nom du fichier doit comporter l'extension .tf, par exemple main.tf. Dans ce tutoriel, le fichier est appelé main.tf.
```
mkdir DIRECTORY && cd DIRECTORY && touch main.tf
```
Si vous suivez un tutoriel, vous pouvez copier l'exemple de code dans chaque section ou étape.

Copiez l'exemple de code dans le fichier main.tf que vous venez de créer.

Vous pouvez également copier le code depuis GitHub. Cela est recommandé lorsque l'extrait Terraform fait partie d'une solution de bout en bout.
Examinez et modifiez les exemples de paramètres à appliquer à votre environnement.
Enregistrez les modifications.
Initialisez Terraform. Cette opération n'est à effectuer qu'une seule fois par répertoire.
```
terraform init
```
Vous pouvez également utiliser la dernière version du fournisseur Google en incluant l'option -upgrade :
```
terraform init -upgrade
```

Appliquer les modifications

Examinez la configuration et vérifiez que les ressources que Terraform va créer ou mettre à jour correspondent à vos attentes :
```
terraform plan
```
Corrigez les modifications de la configuration si nécessaire.
Appliquez la configuration Terraform en exécutant la commande suivante et en saisissant yes lorsque vous y êtes invité :
```
terraform apply
```
Attendez que Terraform affiche le message "Apply completed!" (Application terminée).
Ouvrez votre projet Google Cloud pour afficher les résultats. Dans la console Google Cloud, accédez à vos ressources dans l'interface utilisateur pour vous assurer que Terraform les a créées ou mises à jour.

Supprimer les modifications

Pour supprimer vos modifications, procédez comme suit :

Pour désactiver la protection contre la suppression, définissez l'argument deletion_protection sur false dans le fichier de configuration Terraform.
```
deletion_protection =  "false"
```
Appliquez la configuration Terraform mise à jour en exécutant la commande suivante et en saisissant yes lorsque vous y êtes invité :
```
terraform apply
```

Supprimez les ressources précédemment appliquées à votre configuration Terraform en exécutant la commande suivante et en saisissant yes à la requête :
```
terraform destroy
```

REST v1

La requête suivante exécute la méthode databases:insert pour créer une base de données sur l'instance spécifiée.

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

project-id : ID du projet
instance-id : ID de l'instance.
database-name : nom d'une base de données dans l'instance Cloud SQL.

Méthode HTTP et URL :

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases

Corps JSON de la requête :

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "database-name"
}

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

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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/instance-id/databases"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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/instance-id/databases" | Select-Object -Expand Content

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

Réponse

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "CREATE_DATABASE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

La requête suivante exécute la méthode databases:insert pour créer une base de données sur l'instance spécifiée.

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

project-id : ID du projet
instance-id : ID de l'instance.
database-name : nom d'une base de données dans l'instance Cloud SQL.

Méthode HTTP et URL :

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases

Corps JSON de la requête :

{
  "project": "project-id",
  "instance": "instance-id",
  "name": "database-name"
}

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

curl (Linux, macOS ou Cloud Shell)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

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/instance-id/databases"

PowerShell (Windows)

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$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/instance-id/databases" | Select-Object -Expand Content

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

Réponse

{
  "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-21T22:43:37.981Z",
  "operationType": "CREATE_DATABASE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Client mysql

Pour plus d'informations, consultez CRÉER UNE BASE DE DONNÉES dans la documentation MySQL.

Pour plus d'informations sur les jeux de caractères et les classements, consultez Jeu de caractères, classements, Unicode.

CREATE DATABASE database_name
  [[CHARACTER SET charset_name][COLLATE collation_name]];

Lister les bases de données

Pour répertorier toutes les bases de données d'une instance :

Console

Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Cliquez sur Bases de données dans le menu de gauche. La page Bases de données répertorie les bases de données ainsi que leur type de classement, leur jeu de caractères et leur type de base de données.

gcloud

Pour plus d'informations, consultez la page sur gcloud sql databases list.

gcloud sql databases list \
--instance=INSTANCE_NAME

REST v1

La requête suivante exécute la méthode databases:list pour répertorier les bases de données d'une instance.

Lorsque vous répertoriez les bases de données à l'aide de l'API, vous voyez des bases de données de modèles supplémentaires ainsi qu'une base de données système qui ne sont pas affichées par la console. Vous ne pouvez pas supprimer ni gérer la base de données système.

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

project-id : ID du projet
instance-id : ID de l'instance.

Méthode HTTP et URL :

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases

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

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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

PowerShell (Windows)

Exécutez la commande suivante :

$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/databases" | Select-Object -Expand Content

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

Réponse

{
  "kind": "sql#database",
  "charset": "utf8",
  "collation": "utf8_general_ci",
  "etag": "etag",
  "name": "sys",
  "instance": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/sys",
  "project": "project-id"
}

REST v1beta4

La requête suivante exécute la méthode databases:list pour répertorier les bases de données d'une instance.

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

project-id : ID du projet
instance-id : ID de l'instance.

Méthode HTTP et URL :

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases

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

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

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

PowerShell (Windows)

Exécutez la commande suivante :

$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/databases" | Select-Object -Expand Content

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

Réponse

{
  "kind": "sql#database",
  "charset": "utf8",
  "collation": "utf8_general_ci",
  "etag": "etag",
  "name": "sys",
  "instance": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/sys",
  "project": "project-id"
}

Client mysql

Pour plus d'informations, consultez AFFICHER LES BASES DE DONNÉES dans la documentation MySQL.

SHOW DATABASES;

Supprimer une base de données

Pour supprimer une base de données sur l'instance Cloud SQL :

Console

Dans Google Cloud Console, accédez à la page Instances Cloud SQL.

Accéder à la page Instances Cloud SQL
Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
Cliquez sur Bases de données dans le menu de gauche.
Dans la liste des bases de données, recherchez celle que vous souhaitez supprimer et cliquez sur l'icône de la corbeille.
Dans la boîte de dialogue Supprimer la base de données, saisissez le nom de la base de données, puis cliquez sur Supprimer.

Remarque : La suppression d'une base de données supprime tous les fichiers du répertoire de la base de données, y compris les fichiers qui ne sont pas directement utilisés par la base de données, tels que les fichiers #sql-* créés à partir d'opérations ALTER TABLE interrompues dans MySQL 5.6 et MySQL 5.7.

gcloud

Pour plus d'informations, consultez la page sur gcloud sql databases delete.

gcloud sql databases delete DATABASE_NAME \
--instance=INSTANCE_NAME

Remarque : La suppression d'une base de données supprime tous les fichiers du répertoire de la base de données, y compris les fichiers qui ne sont pas directement utilisés par la base de données. tels que les fichiers #sql-* créés à partir d'opérations ALTER TABLE interrompues dans MySQL 5.6 et MySQL 5.7.

REST v1

La requête suivante exécute la méthode databases:delete pour supprimer la base de données spécifiée.

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

project-id : ID du projet
instance-id : ID de l'instance.
database-name : nom d'une base de données dans l'instance Cloud SQL.

Méthode HTTP et URL :

DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name

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

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name"

PowerShell (Windows)

Exécutez la commande suivante :

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/databases/database-name" | Select-Object -Expand Content

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

Réponse

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE_DATABASE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

REST v1beta4

La requête suivante exécute la méthode databases:delete pour supprimer la base de données spécifiée.

Remarque : La suppression d'une base de données supprime tous les fichiers du répertoire de la base de données, y compris les fichiers qui ne sont pas directement utilisés par la base de données, tels que les fichiers #sql-* créés à partir d'opérations ALTER TABLE interrompues dans MySQL 5.6 et MySQL 5.7.

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

project-id : ID du projet
instance-id : ID de l'instance.
database-name : nom d'une base de données dans l'instance Cloud SQL.

Méthode HTTP et URL :

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name

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

curl (Linux, macOS ou Cloud Shell)

Exécutez la commande suivante :

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name"

PowerShell (Windows)

Exécutez la commande suivante :

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

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/databases/database-name" | Select-Object -Expand Content

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

Réponse

{
  "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-21T22:43:37.981Z",
  "operationType": "DELETE_DATABASE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Client mysql

Pour plus d'informations, consultez SUPPRIMER LES BASES DE DONNÉES dans la documentation MySQL.

DROP DATABASE [database_name];

Remarque : Si le répertoire de la base de données contient des fichiers qui ne sont pas directement utilisés par la base de données, la commande DROP DATABASE génère des erreurs indiquant que le répertoire de la base de données ne doit pas être supprimé, tels que :

Erreur lors de la suppression de la base de données (can't rmdir "./database_name", errno: 39)
Erreur lors de la suppression de la base de données (can't rmdir "./database_name", errno: 17)

Ces fichiers peuvent être par exemple des fichiers #sql-* créés à partir des opérations ALTER TABLE interrompues dans MySQL 5.6 et MySQL 5.7. Pour supprimer ces fichiers et terminer l'opération DROP DATABASE, répétez l'opération à l'aide de l'une des autres méthodes : la console, la commande gcloud ou l'appel d'API REST.

Étape suivante

Gérez les utilisateurs de l'instance.
Importez des données dans l'instance.
Découvrez les options de connexion à l'instance à l'aide du client mysql.
Créez une table de base de données.
Procédures stockées Cloud SQL pour MySQL

Faites l'essai

Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de Cloud SQL en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

Profiter d'un essai gratuit de Cloud SQL