Cette page explique comment créer une instance Cloud SQL pour MySQL.
Pour en savoir plus sur l'ensemble des paramètres d'instance, consultez la page Paramètres des instances.
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.
Le nombre maximal d'instances que vous pouvez avoir dans un même projet dépend de l'architecture réseau de ces instances:
- Nouvelle architecture réseau SQL: vous pouvez avoir jusqu'à 1 000 instances par projet.
- Ancienne architecture réseau SQL: vous pouvez avoir jusqu'à 100 instances par projet.
- Utilisation des deux architectures: votre limite se situe entre 100 et 1 000, en fonction de la répartition de vos instances entre les deux architectures.
Déposez une demande d'assistance si vous souhaitez augmenter cette limite. Les instances dupliquées avec accès en lecture sont considérées comme des instances.
Avant de commencer
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Install the gcloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init -
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Install the gcloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init - Assurez-vous de disposer des rôles d'administrateur Cloud SQL et de lecteur de Compute sur votre compte utilisateur.
En savoir plus sur les rôles et les autorisations
-
Dans la Google Cloud console, accédez à la page Instances Cloud SQL.
- Cliquez sur Créer une instance.
- Dans le panneau Choisissez votre moteur de base de données de la page Créer une instance, cliquez sur Choisir MySQL.
Dans la section Choisir une édition Cloud SQL de la page Créer une instance SQL Server, sélectionnez l'édition Cloud SQL à appliquer à votre instance:
EnterpriseouEnterprise Plus.Pour en savoir plus sur les éditions Cloud SQL, consultez la page Présentation des éditions Cloud SQL.
- Sélectionnez le préréglage d'édition à appliquer à votre instance. Pour afficher les préréglages disponibles, cliquez sur le menu Préréglage d'édition.
- Dans la section Informations sur l'instance, sélectionnez la version de la base de données à appliquer à votre instance. Pour afficher les versions disponibles, cliquez sur le menu Version de la base de données.
Facultatif : Sélectionnez Afficher les versions mineures. Sélectionnez ensuite une version mineure autre que la version mineure par défaut.
Une fois l'instance créée, la version de la base de données ne peut plus être modifiée.
- Dans le champ ID d'instance du volet d'informations de l'instance, saisissez un ID pour votre instance.
Vous n'avez pas besoin d'indiquer l'ID du projet. qui sera ajouté automatiquement le cas échéant (par exemple, dans les fichiers journaux).
- Définissez un mot de passe pour l'utilisateur racine.
Vous avez la possibilité de définir l'option Aucun mot de passe, mais cela n'est pas recommandé pour des raisons de sécurité.
-
Facultatif: configurez une règle de mot de passe pour l'instance comme suit :
- Cochez la case Activer les règles sur les mots de passe.
- Cliquez sur le bouton Définir une règle de mot de passe, définissez une ou plusieurs des options suivantes, puis cliquez sur Enregistrer.
- Longueur minimale : spécifie le nombre minimal de caractères que le mot de passe doit contenir.
- Complexité du mot de passe: vérifie si le mot de passe est une combinaison de caractères minuscules, majuscules, numériques et non alphanumériques.
- Restreindre la réutilisation des mots de passe: spécifie le nombre de mots de passe précédents que vous ne pouvez pas réutiliser.
Uniquement compatible avec Cloud SQL pour MySQL 8.0 et versions ultérieures.
- Interdire le nom d'utilisateur : empêche de spécifier le nom d'utilisateur dans le mot de passe.
- Dans la section Sélectionner la disponibilité régionale et zonale, sélectionnez la région et la zone de votre instance. La disponibilité des régions peut être différente en fonction de votre édition Cloud SQL pour MySQL. Pour en savoir plus, consultez la page À propos des paramètres d'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.
Si vous configurez votre instance pour la haute disponibilité, vous pouvez sélectionner à la fois une zone principale et une zone secondaire.
Les conditions suivantes s'appliquent lorsque la zone secondaire est utilisée lors de la création de l'instance :
- Les zones par défaut sont
Anypour la zone principale etAny (different from primary)pour la zone secondaire. - Si les zones principale et secondaire sont spécifiées, elles doivent être distinctes l'une de l'autre.
- Les zones par défaut sont
- Dans la section Personnaliser votre instance, mettez à jour les paramètres de votre instance.
Commencez par cliquer sur Afficher les options de configuration pour afficher les groupes de paramètres. Développez ensuite les groupes que vous souhaitez examiner et personnalisez les paramètres.
Un résumé de toutes les options sélectionnées s'affiche à droite.
La personnalisation des paramètres de l'instance est facultative. Des valeurs par défaut sont attribuées chaque fois qu'aucune personnalisation n'est effectuée.
Le tableau suivant présente un récapitulatif des paramètres d'instances. Pour en savoir plus sur chaque paramètre, consultez la page Paramètres des instances.
Paramètre Remarques Type de machine Type de machine Sélectionnez l'option "Cœur partagé" ou "Cœur dédié". Avec l'option "Cœur partagé", chaque type de machine est classé selon le nombre de processeurs (cœurs) et la quantité de mémoire de votre instance. Cœurs Nombre de processeurs virtuels de votre instance. En savoir plus Mémoire Quantité de mémoire disponible pour votre instance (en Go). En savoir plus Personnalisée Pour le type de machine à cœur dédié, au lieu de sélectionner une configuration prédéfinie, cliquez sur le bouton Personnalisé pour créer une instance avec une configuration personnalisée. Lorsque vous sélectionnez cette option, vous devez choisir le nombre de cœurs et la quantité de mémoire de votre instance. En savoir plus Stockage Type de stockage Détermine si l'instance utilise un stockage SSD ou HDD. En savoir plus Capacité de stockage Quantité de stockage fournie pour l'instance. En savoir plus Activer l'augmentation automatique de l'espace de stockage Détermine si Cloud SQL fournit automatiquement plus d'espace de stockage pour l'instance lorsque l'espace disponible est presque épuisé. En savoir plus Chiffrement Chiffrement géré par Google Il s'agit de l'option par défaut. Clé de chiffrement gérée par le client (CMEK) Sélectionnez cette option pour utiliser votre clé avec Google Cloud Key Management Service. En savoir plus Connexions Adresse IP privée Ajoute une adresse IP privée pour l'instance. Pour activer la connexion à l'instance, une configuration supplémentaire est requise.
Vous pouvez éventuellement spécifier une plage d'adresses IP allouée pour vos instances à utiliser pour les connexions.- Développez l'option Afficher la plage d'adresses IP allouée.
- Sélectionnez une plage d'adresses IP dans le menu déroulant.
Votre instance peut avoir une adresse IP publique et une adresse IP privée.
Adresse IP publique Ajoute une adresse IP publique pour l'instance. Vous pouvez ensuite ajouter des réseaux autorisés pour vous connecter à l'instance. Votre instance peut avoir une adresse IP publique et une adresse IP privée.
Réseaux autorisés Ajoutez le nom du nouveau réseau et son adresse. En savoir plus
Chemin d'accès privé pour les services Google Cloud En cochant cette case, vous autorisez d'autres Google Cloud services, tels que BigQuery, à accéder aux données dans Cloud SQL et à effectuer des requêtes sur ces données via une connexion privée.
Activer le pool de connexions géré En cochant cette case, vous activez le regroupement de connexions géré pour votre instance. Le pool de connexions géré vous permet de faire évoluer vos charges de travail en optimisant l'utilisation des ressources et la latence de connexion des instances Cloud SQL à l'aide du pool et du multiplexage. Pour en savoir plus sur le pooling de connexions géré, consultez la présentation du pooling de connexions géré.
Sécurité Mode d'autorité de certification du serveur Choisissez le type d'autorité de certification (CA) qui signe le certificat de serveur pour cette instance Cloud SQL. En savoir plus
Par défaut, lorsque vous créez une instance dans la console Google Cloud , l'instance utilise l'autorité de certification interne gérée par Google (
GOOGLE_MANAGED_INTERNAL_CA), qui est l'option d'autorité de certification par instance.Protection des données Automatiser les sauvegardes Période durant laquelle vous souhaitez que les sauvegardes commencent. En savoir plus Choisissez l'emplacement de stockage de vos sauvegardes Sélectionnez l'emplacement multirégional pour la plupart des cas d'utilisation. Si vous devez stocker des sauvegardes dans une région spécifique, pour des raisons réglementaires par exemple, cliquez sur "Région" et sélectionnez votre région dans le menu déroulant "Emplacement". Choisissez le nombre de sauvegardes automatiques à stocker Nombre de sauvegardes automatiques que vous souhaitez conserver (de 1 à 365 jours). En savoir plus Activer la récupération à un moment précis Permet la récupération à un moment précis et la journalisation préalable (write-ahead logging). En savoir plus Activer la protection contre la suppression Détermine s'il faut protéger une instance contre toute suppression accidentelle. En savoir plus Activer la conservation des sauvegardes après la suppression de l'instance Détermine si les sauvegardes automatiques et à la demande sont conservées après la suppression d'une instance. En savoir plus Choisir le nombre de jours de journaux à conserver Définit la durée de conservation des journaux WAL (write-ahead log) entre un et sept jours. La valeur par défaut est de sept jours. En savoir plus Maintenance Intervalle souhaité Détermine un intervalle d'une heure pendant lequel Cloud SQL peut effectuer des opérations de maintenance entraînant des perturbations sur l'instance. Si vous ne le définissez pas, la maintenance peut être réalisée à tout moment. En savoir plus Ordre des mises à jour Période privilégiée pour les mises à jour de l'instance, par rapport aux autres instances du même projet. En savoir plus Flags Ajouter un indicateur Les indicateurs de base de données permettent de contrôler les réglages et les paramètres de l'instance. En savoir plus Libellés AJOUTER UN LIBELLÉ Ajoutez une clé et une valeur pour chaque libellé que vous ajoutez. Les libellés vous servent à organiser vos instances. Cache de données Activer le cache de données (facultatif) Active le cache de données pour les instances Cloud SQL pour MySQL Enterprise Plus. Pour en savoir plus sur le cache de données, consultez la section Cache de données. - Cliquez sur Créer une instance.
Remarque : La création de l'instance peut prendre quelques minutes. Cependant, vous pouvez afficher des informations sur l'instance pendant sa création.
- Utilisez la commande
gcloud sql instances createpour créer l'instance: - Le nombre de processeurs virtuels doit correspondre à 1 ou à un nombre pair compris entre 2 et 96.
- La taille de la mémoire doit répondre aux critères suivants :
- La mémoire doit être comprise entre 0,9 Go et 6,5 Go par processeur virtuel.
- La taille de la mémoire doit être un multiple de 256 Mo.
- La taille de la mémoire ne doit pas être inférieure à 3,75 Go (3 840 Mo).
- Les zones doivent être valides.
- Si la zone secondaire est spécifiée, la zone principale doit également être spécifiée.
- Si les zones principale et secondaire sont spécifiées, elles doivent être distinctes l'une de l'autre.
- Si les zones principale et secondaire sont spécifiées, elles doivent appartenir à la même région.
- Vous utilisez le paramètre
--no-assign-ip. - Vous utilisez le paramètre
--networkpour spécifier le nom du réseau VPC que vous souhaitez utiliser pour créer une connexion privée. GOOGLE_MANAGED_INTERNAL_CA: valeur par défaut. Avec cette option, une autorité de certification interne dédiée à chaque instance Cloud SQL signe le certificat de serveur de cette instance.GOOGLE_MANAGED_CAS_CA: avec cette option, une hiérarchie d'autorités de certification composée d'une autorité de certification racine et d'autorités de certification de serveurs subordonnées gérées par Cloud SQL et hébergées sur le service d'autorité de certification ( Google Cloud Certificate Authority Service) est utilisée. Les autorités de certification de serveur subordonnées d'une région signent les certificats de serveur et sont partagées entre les instances de la région. Cette option n'est compatible qu'avec MySQL 8.0.30 et versions ultérieures.CUSTOMER_MANAGED_CAS_CA: avec cette option, vous définissez la hiérarchie des autorités de certification et gérez la rotation des certificats de l'autorité de certification. Vous créez un pool d'autorités de certification dans le service d'autorité de certification dans la même région que votre instance. L'une des autorités de certification du pool est utilisée pour signer le certificat du serveur. Cette option n'est compatible qu'avec MySQL 8.0.30 et versions ultérieures. Pour en savoir plus, consultez Utiliser une autorité de certification gérée par le client.- Les zones doivent être valides.
- Si la zone secondaire est spécifiée, la zone principale doit également être spécifiée.
- 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.
- Définissez le mot de passe de l'utilisateur MySQL "root@%" :
gcloud sql users set-password root \ --host=% \ --instance INSTANCE_NAME \ --password PASSWORD
- 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.
-
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 exemplemain.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.tfque 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
-
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
yeslorsque vous y êtes invité :terraform apply
Attendez que Terraform affiche le message "Apply completed!" (Application terminée).
- Ouvrez votre Google Cloud projet 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.
- Pour désactiver la protection contre la suppression, définissez l'argument
deletion_protectionsurfalsedans le fichier de configuration Terraform.deletion_protection = "false"
- Appliquez la configuration Terraform mise à jour en exécutant la commande suivante et en saisissant
yeslorsque 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
- PROJECT_ID : ID de votre projet.
- INSTANCE_ID : Votre ID d'instance
- DATABASE_VERSION : version de la base de données.
Par exemple,
MYSQL_8_4ouMYSQL_8_0_37. Si vous ne spécifiez pas de version de base de données, la version par défaut estMYSQL_8_0. - REGION : région
- MACHINE_TYPE : votre type de machine
- EDITION_TYPE : votre édition Cloud SQL
- DATA_CACHE_ENABLED (facultatif) : défini sur
truepour activer le cache de données pour votre instance. - PRIVATE_NETWORK spécifiez le nom du réseau cloud privé virtuel (VPC) que vous souhaitez utiliser pour cette instance. L'accès aux services privés doit déjà être configuré pour le réseau.
- AUTHORIZED_NETWORKS : pour les connexions IP publiques, spécifiez les connexions à partir de réseaux autorisés pouvant vous connecter à l'instance.
- CA_MODE: spécifiez une hiérarchie d'autorité de certification pour l'instance,
GOOGLE_MANAGED_INTERNAL_CAouGOOGLE_MANAGED_CAS_CA. Si vous ne spécifiez passerverCaMode, la configuration par défaut estGOOGLE_MANAGED_INTERNAL_CA. Cette fonctionnalité est disponible en version preview. - DNS_NAMES: ajoutez une liste de trois noms DNS maximum, séparés par des virgules, au certificat du serveur de votre instance Cloud SQL. Vous pouvez sécuriser plusieurs noms DNS avec un seul certificat. Cette fonctionnalité est disponible en version preview et pour les instances
CUSTOMER_MANAGED_CAS_CAuniquement. enablePasswordPolicy: active la règle de mot de passe lorsqu'elle est définie surtrue.Pour supprimer la règle de mot de passe, vous pouvez utiliser une requête
PATCHavecnullcomme valeur pourenablePasswordPolicy. Dans ce cas, les autres paramètres des règles sur les mots de passe sont réinitialisés.minLength: spécifie le nombre minimal de caractères que le mot de passe doit contenir.complexity: vérifie si le mot de passe est une combinaison de caractères minuscules, majuscules, numériques et non alphanumériques. La valeur par défaut estCOMPLEXITY_DEFAULT.reuseInterval: indique le nombre de mots de passe précédents que vous ne pouvez pas réutiliser.Uniquement compatible avec Cloud SQL pour MySQL 8.0 et versions ultérieures.
disallowUsernameSubstring: empêche l'utilisation du nom d'utilisateur dans le mot de passe lorsqu'il est défini surtrue.- project-id : ID de votre projet.
- instance-id : ID de l'instance créée à l'étape précédente
- root-password : mot de passe racine souhaité
- project-id : ID de votre projet.
- instance-id : ID de l'instance créée à l'étape précédente
- PROJECT_ID : ID de votre projet.
- INSTANCE_ID : Votre ID d'instance
- DATABASE_VERSION : version de la base de données.
Par exemple,
MYSQL_8_4ouMYSQL_8_0_37. Si vous ne spécifiez pas de version de base de données, la version par défaut estMYSQL_8_0. - REGION : région
- MACHINE_TYPE : votre type de machine
- EDITION_TYPE : votre édition Cloud SQL
- DATA_CACHE_ENABLED (facultatif) : défini sur
truepour activer le cache de données pour votre instance. - PRIVATE_NETWORK spécifiez le nom du réseau cloud privé virtuel (VPC) que vous souhaitez utiliser pour cette instance. L'accès aux services privés doit déjà être configuré pour le réseau.
- AUTHORIZED_NETWORKS : pour les connexions IP publiques, spécifiez les connexions à partir de réseaux autorisés pouvant vous connecter à l'instance.
- CA_MODE: spécifiez une hiérarchie d'autorité de certification pour l'instance,
GOOGLE_MANAGED_INTERNAL_CAouGOOGLE_MANAGED_CAS_CA. Si vous ne spécifiez passerverCaMode, la configuration par défaut estGOOGLE_MANAGED_INTERNAL_CA. Cette fonctionnalité est disponible en version preview. - DNS_NAMES: ajoutez une liste de trois noms DNS maximum, séparés par des virgules, au certificat du serveur de votre instance Cloud SQL. Vous pouvez sécuriser plusieurs noms DNS avec un seul certificat. Cette fonctionnalité est disponible en version preview et pour les instances
CUSTOMER_MANAGED_CAS_CAuniquement. enablePasswordPolicy: active la règle de mot de passe lorsqu'elle est définie surtrue.Pour supprimer la règle de mot de passe, vous pouvez utiliser une requête
PATCHavecnullcomme valeur pourenablePasswordPolicy. Dans ce cas, les autres paramètres des règles sur les mots de passe sont réinitialisés.minLength: spécifie le nombre minimal de caractères que le mot de passe doit contenir.complexity: vérifie si le mot de passe est une combinaison de caractères minuscules, majuscules, numériques et non alphanumériques. La valeur par défaut estCOMPLEXITY_DEFAULT.reuseInterval: indique le nombre de mots de passe précédents que vous ne pouvez pas réutiliser.Uniquement compatible avec Cloud SQL pour MySQL 8.0 et versions ultérieures.
disallowUsernameSubstring: empêche l'utilisation du nom d'utilisateur dans le mot de passe lorsqu'il est défini surtrue.- project-id : ID de votre projet.
- instance-id : ID de l'instance créée à l'étape précédente
- root-password : mot de passe racine souhaité
- project-id : ID de votre projet.
- instance-id : ID de l'instance créée à l'étape précédente
- INSTANCE_NAME : nom de l'instance
- DATABASE_VERSION: version mineure de la base de données de l'instance :
MYSQL_8_0_18,MYSQL_8_0_26,MYSQL_8_0_27,MYSQL_8_0_28,MYSQL_8_0_29,MYSQL_8_0_30,MYSQL_8_0_31,MYSQL_8_0_32,MYSQL_8_0_33,MYSQL_8_0_34,MYSQL_8_0_35,MYSQL_8_0_36,MYSQL_8_0_37,MYSQL_8_0_39,MYSQL_8_0_40,MYSQL_8_0_41ouMYSQL_8_0_42. Si vous spécifiezMYSQL_8_0, la version mineure par défaut est utilisée.Si vous ne spécifiez pas cette option, la version majeure par défaut,
MYSQL_8_0, est utilisée. - project_id : ID du projet
- instance_id : nom de l'instance
- databaseVersion: version de la base de données de l'instance :
MYSQL_8_0_18,MYSQL_8_0_26,MYSQL_8_0_27,MYSQL_8_0_28,MYSQL_8_0_29,MYSQL_8_0_30,MYSQL_8_0_31,MYSQL_8_0_32,MYSQL_8_0_33,MYSQL_8_0_34,MYSQL_8_0_35,MYSQL_8_0_36,MYSQL_8_0_37,MYSQL_8_0_39,MYSQL_8_0_40(version mineure par défaut pour MySQL 8.0),MYSQL_8_0_41ouMYSQL_8_0_42. Si vous spécifiezMYSQL_8_0comme version, la version mineure par défaut est utilisée. Si vous ne spécifiez pas l'indicateurdatabaseVersion, la version majeure par défaut,MYSQL_8_0, est utilisée. - project_id : ID du projet
- instance_id : nom de l'instance
- databaseVersion : version de la base de données de l'instance :
MYSQL_8_0_18,MYSQL_8_0_26,MYSQL_8_0_27,MYSQL_8_0_28,MYSQL_8_0_29,MYSQL_8_0_30,MYSQL_8_0_31,MYSQL_8_0_32,MYSQL_8_0_33.MYSQL_8_0_34,MYSQL_8_0_35,MYSQL_8_0_36,MYSQL_8_0_37,MYSQL_8_0_39,MYSQL_8_0_40(version mineure par défaut pour MySQL 8.0),MYSQL_8_0_41ouMYSQL_8_0_42. Si vous spécifiezMYSQL_8_0, la version mineure par défaut est utilisée. Si vous ne spécifiez pas l'indicateurdatabaseVersion, la version majeure par défaut,MYSQL_8_0, est utilisée. - La taille de la plage d'adresses IP allouée à la connexion de service privé est inférieure à /24.
- La taille de la plage d'adresses IP allouée pour la connexion de service privé est trop petite pour le nombre d'instances Cloud SQL.
- La taille requise pour la plage d'adresses IP allouée sera plus importante si les instances sont créées dans plusieurs régions. Voir Taille de la plage allouée
- Elles ne contiennent pas de caractères génériques.
- Ils ne doivent pas se terminer par un point.
- Ils respectent les spécifications de la RFC 1034.
- Créez une base de données MySQL sur l'instance.
- Créez des utilisateurs MySQL sur l'instance.
- Sécurisez et contrôlez l'accès à l'instance.
- Connectez-vous à l'instance avec un client MySQL.
- Importez des données dans la base de données.
- En savoir plus sur les paramètres des instances
Créer une instance MySQL
Console
Pour afficher le mot de passe en texte clair, cliquez sur l'icône Afficher le mot de passe.
Vous pouvez saisir le mot de passe manuellement ou cliquer sur Générer pour que Cloud SQL en crée un automatiquement.
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.
Pour les instances Cloud SQL Enterprise Plus :
gcloud sql instances create INSTANCE_NAME \ --region=REGION \ --tier=TIER \ --database-version=DATABASE_VERSION \ --edition=ENTERPRISE_PLUS
Pour les instances Cloud SQL Enterprise:
gcloud sql instances create INSTANCE_NAME \ --cpu=NUMBER_CPUS \ --memory=MEMORY_SIZE \ --region=REGION
--tier si vous choisissez le type de machine db-f1-micro ou db-g1-small:
gcloud sql instances create INSTANCE_NAME \ --tier=API_TIER_STRING \ --region=REGION
Les valeurs relatives au nombre de processeurs virtuels et à la taille de la mémoire sont soumises à des restrictions :
Par exemple, la commande suivante crée une instance de l'édition Cloud SQL Enterprise avec deux processeurs virtuels et 7 680 Mo de mémoire:
gcloud sql instances create myinstance \ --database-version=MYSQL_8_0 \ --cpu=2 \ --memory=7680MB \ --region=us-central1
La commande suivante crée une instance Cloud SQL Enterprise Plus avec quatre cœurs :
gcloud sql instances create myinstance \ --database-version=MYSQL_8_0_31 \ --tier=db-perf-optimized-N-4 \ --edition=ENTERPRISE_PLUS \ --region=us-central1
La valeur par défaut de REGION est us-central1.
N'incluez pas d'informations sensibles ou personnelles dans le nom de l'instance, car les utilisateurs externes peuvent le voir.
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).
Si vous créez une instance pour la haute disponibilité, vous pouvez spécifier les zones principale et la zone secondaire à l'aide des paramètres --zone et --secondary-zone. Les conditions suivantes s'appliquent lorsque la zone secondaire est utilisée lors de la création ou de la modification de l'instance :
Vous pouvez ajouter d'autres paramètres pour définir d'autres paramètres d'instance:
| Paramètre | Paramètre | Remarques |
|---|---|---|
| Réglages obligatoires | ||
| Version de la base de données | --database-version |
La version de la base de données, qui est basée sur votre édition Cloud SQL. |
| Région | --region |
Consultez les valeurs valides. |
| Définir une règle de mot de passe | ||
| Activer la règle sur les mots de passe | --enable-password-policy |
Active la stratégie de mot de passe lorsqu'utilisé. Par défaut, les règles sur les mots de passe sont désactivées. Lorsqu'elles sont désactivées à l'aide du paramètre --clear-password-policy, les autres paramètres de règles sur les mots de passe sont réinitialisés.
|
| Longueur minimale | --password-policy-min-length |
Indique le nombre minimal de caractères que le mot de passe doit contenir. |
| Complexité du mot de passe | --password-policy-complexity |
Permet à la vérification du niveau de complexité du mot de passe de s'assurer que le mot de passe contient chacun des types de caractères suivants : minuscules, majuscules, numériques et non alphanumériques. Définissez la valeur sur COMPLEXITY_DEFAULT. |
| Restreindre la réutilisation des mots de passe | --password-policy-reuse-interval |
Indique le nombre de mots de passe précédents que vous ne pouvez pas réutiliser. Uniquement compatible avec Cloud SQL pour MySQL 8.0 et versions ultérieures. |
| Interdire le nom d'utilisateur | --password-policy-disallow-username-substring |
Empêche l'utilisation du nom d'utilisateur dans le mot de passe. Utilisez le paramètre --no-password-policy-disallow-username-substring pour désactiver la vérification. |
| Connectivité | ||
| Adresse IP privée | --network
|
--network : Spécifie le nom du réseau VPC que vous souhaitez utiliser pour cette instance. L'accès aux services privés doit déjà être configuré pour le réseau. Disponible uniquement avec la commande bêta (gcloud beta sql instances create).
Ce paramètre n'est valide que dans les cas suivants : |
| Adresse IP publique | --authorized-networks |
Pour les connexions IP publiques, seules des connexions à partir de réseaux autorisés peuvent être établies avec l'instance. En savoir plus |
| Utilisation du protocole SSL |
|
Le paramètre Le paramètre |
| Mode d'autorité de certification du serveur | --server-ca-mode |
L'indicateur |
| Type de machine et stockage | ||
| Type de machine | --tier |
Permet de spécifier une instance à cœur partagé (db-f1-micro ou db-g1-small). Pour mettre en œuvre une configuration d'instance personnalisée, utilisez plutôt les paramètres --cpu ou --memory. Consultez la section Configuration d'instances personnalisées.
|
| Type de stockage | --storage-type |
Détermine si l'instance utilise un stockage SSD ou HDD. En savoir plus |
| Capacité de stockage | --storage-size |
Quantité de stockage fournie pour l'instance, en Go. En savoir plus |
| Augmentation automatique de l'espace de stockage | --storage-auto-increase |
Détermine si Cloud SQL fournit automatiquement plus d'espace de stockage pour l'instance lorsque l'espace disponible est presque épuisé. En savoir plus |
| Limite de l'augmentation automatique de l'espace de stockage | --storage-auto-increase-limit |
Détermine dans quelle limite Cloud SQL peut automatiquement augmenter l'espace de stockage.
Disponible uniquement avec la commande bêta (gcloud beta sql instances create). En savoir plus
|
| Cache de données (facultatif) | --enable-data-cache |
Active ou désactive le cache de données pour les instances. Pour en savoir plus, consultez la section Cache de données. |
| Sauvegardes automatiques et haute disponibilité | ||
| Haute disponibilité | --availability-type |
Pour une instance à disponibilité élevée, définissez ce paramètre sur REGIONAL. En savoir plus |
| Zone secondaire | --secondary-zone |
Si vous créez une instance pour la haute disponibilité, vous pouvez spécifier la zone principale et la zone secondaire à l'aide de --zone et de --secondary-zone parameters. Les restrictions suivantes s'appliquent lorsque la zone secondaire est utilisée lors de la création ou de la modification de l'instance :Si les zones principale et secondaire sont spécifiées, elles doivent être distinctes l'une de l'autre. Si les zones principale et secondaire sont spécifiées, elles doivent appartenir à la même région. |
| Sauvegardes automatiques | --backup-start-time |
Période durant laquelle vous souhaitez que les sauvegardes commencent. En savoir plus |
| Paramètres de conservation des sauvegardes automatiques | --retained-backups-count |
Nombre de sauvegardes automatiques à conserver. En savoir plus |
| Journalisation binaire | --enable-bin-log |
La journalisation binaire permet la réplication et la récupération à un moment précis. En savoir plus |
| Paramètres de conservation pour la journalisation binaire | --retained-transaction-log-days |
Nombre de jours pendant lesquels les journaux binaires doivent être conservés pour la récupération à un moment précis. En savoir plus |
| Récupération à un moment précis | --enable-point-in-time-recovery |
Permet la récupération à un moment précis et la journalisation préalable (write-ahead logging). En savoir plus |
| Ajouter des indicateurs de base de données | ||
| Indicateurs de base de données | --database-flags |
Les indicateurs de base de données permettent de contrôler les réglages et les paramètres de l'instance. Apprenez-en plus sur les indicateurs de base de données. En savoir plus sur le formatage de ce paramètre. |
| Calendrier de maintenance | ||
| Intervalle de maintenance | --maintenance-window-day,--maintenance-window-hour |
Détermine un intervalle d'une heure pendant lequel Cloud SQL peut effectuer des opérations de maintenance entraînant des perturbations sur l'instance. Si vous ne le définissez pas, la maintenance peut être réalisée à tout moment. En savoir plus |
| Planification des maintenances | --maintenance-release-channel |
Période privilégiée pour les mises à jour de l'instance, par rapport aux autres instances du même projet. Utilisez preview pour les mises à jour précédentes et production pour les mises à jour ultérieures.
En savoir plus
|
| SAN personnalisé | ||
| Ajouter un autre nom d'objet (SAN) personnalisé | --custom-subject-alternative-names=DNS_NAMES |
Si vous souhaitez utiliser un nom DNS personnalisé pour vous connecter à une instance Cloud SQL au lieu d'utiliser une adresse IP, configurez le paramètre SAN (Subject Alternative Name) personnalisé lors de la création de l'instance. Le nom DNS personnalisé que vous insérez dans le paramètre SAN personnalisé est ajouté au champ SAN du certificat de serveur de l'instance. Vous pouvez ainsi utiliser le nom DNS personnalisé avec la validation du nom d'hôte de manière sécurisée. Avant de pouvoir utiliser le nom DNS personnalisé dans vos clients et applications, vous devez configurer le mappage entre le nom DNS et l'adresse IP. C'est ce qu'on appelle la résolution DNS. Vous pouvez ajouter une liste de trois noms DNS personnalisés, séparés par une virgule, au paramètre SAN personnalisé. |
Terraform
Pour créer une instance, utilisez une ressource Terraform.
Appliquer les modifications
Pour appliquer votre configuration Terraform dans un projet Google Cloud , suivez les procédures des sections suivantes.
Préparer Cloud Shell
Préparer le répertoire
Chaque fichier de configuration Terraform doit avoir son propre répertoire (également appelé module racine).
Appliquer les modifications
Supprimer les modifications
Pour supprimer vos modifications, procédez comme suit :
REST v1
Créer l'instance
Cet exemple crée une instance. Certains paramètres facultatifs, tels que les sauvegardes et la journalisation binaire, sont également inclus. Pour obtenir la liste complète des paramètres de cet appel, consultez la page instances:insert. Pour en savoir plus sur les paramètres des instances, y compris sur les valeurs valides pour la région, consultez la page Paramètres des instances.
N'incluez pas d'informations sensibles ou personnelles dans l'ID d'instance, car les utilisateurs externes peuvent le voir.
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).
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
Pour définir une règle sur les mots de passe lors de la création d'une instance, incluez l'objet passwordValidationPolicy dans la requête. Définissez les paramètres suivants, si nécessaire :
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",
"settings": {
"tier": "MACHINE_TYPE",
"edition": "EDITION_TYPE",
"dataCacheConfig": {
"dataCacheEnabled": DATA_CACHE_ENABLED
},
"backupConfiguration": {
"binaryLogEnabled": true,
"enabled": true
},
"passwordValidationPolicy": {
"enablePasswordPolicy": true
"minLength": "MIN_LENGTH",
"complexity": COMPLEXITY_DEFAULT,
"reuseInterval": "REUSE_INTERVAL",
"disallowUsernameSubstring": "DISALLOW_USERNAME_SUBSTRING",
}
"ipConfiguration": {
"privateNetwork": "PRIVATE_NETWORK",
"authorizedNetworks": [AUTHORIZED_NETWORKS],
"ipv4Enabled": false,
"enablePrivatePathForGoogleCloudServices": true,
"serverCaMode": "CA_MODE",
"customSubjectAlternativeNames": "DNS_NAMES"
}
}
}
Pour envoyer votre requête, développez l'une des options suivantes :
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": "2019-09-25T22:19:33.735Z",
"operationType": "CREATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
La réponse est une opération de longue durée qui peut prendre quelques minutes.
Mettre à jour le mot de passe racine
Une fois l'initialisation de l'instance terminée, mettez à jour le mot de passe racine :
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
Méthode HTTP et URL :
PUT https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/users?host=%25&name=root
Corps JSON de la requête :
{
"name": "root",
"host": "%",
"password": "root-password"
}
Pour envoyer votre requête, développez l'une des options suivantes :
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": "DONE",
"user": "user@example.com",
"insertTime": "2019-09-26T14:32:30.592Z",
"startTime": "2019-09-26T14:32:30.594Z",
"endTime": "2019-09-26T14:32:33.518Z",
"operationType": "UPDATE_USER",
"name": "operation-id",
"targetId": "instance-id",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
Récupérer l'adresse IPv4
Récupérez l'adresse IPv4 attribuée automatiquement pour la nouvelle instance :
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
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 :
Vous devriez recevoir une réponse JSON de ce type :
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "MYSQL_8_0_18",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-f1-micro",
"kind": "sql#settings",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"ipv4Enabled": true
},
"locationPreference": {
"zone": "us-west1-a",
"kind": "sql#locationPreference"
},
"dataDiskType": "PD_SSD",
"backupConfiguration": {
"startTime": "18:00",
"kind": "sql#backupConfiguration",
"enabled": true,
"binaryLogEnabled": true
},
"settingsVersion": "1",
"storageAutoResizeLimit": "0",
"storageAutoResize": true,
"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": "SECOND_GEN",
"selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
"connectionName": "project-id:region:instance-id",
"name": "instance-id",
"region": "us-west1",
"gceZone": "us-west1-a"
}
Recherchez le champ ipAddress dans la réponse.
REST v1beta4
Créer l'instance
Cet exemple crée une instance. Certains paramètres facultatifs, tels que les sauvegardes et la journalisation binaire, sont également inclus. Pour obtenir la liste complète des paramètres de cet appel, consultez la page instances:insert. Pour en savoir plus sur les paramètres des instances, y compris sur les valeurs valides pour la région, consultez la page Paramètres des instances.
N'incluez pas d'informations sensibles ou personnelles dans l'ID d'instance, car les utilisateurs externes peuvent le voir.
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).
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
Pour définir une règle sur les mots de passe lors de la création d'une instance, incluez l'objet passwordValidationPolicy dans la requête. Définissez les paramètres suivants, si nécessaire :
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",
"settings": {
"tier": "MACHINE_TYPE",
"edition": "EDITION_TYPE",
"dataCacheConfig" {
"dataCacheEnabled": DATA_CACHE_ENABLED
},
"backupConfiguration": {
"binaryLogEnabled": true,
"enabled": true
},
"passwordValidationPolicy": {
"enablePasswordPolicy": true
"minLength": "MIN_LENGTH",
"complexity": COMPLEXITY_DEFAULT,
"reuseInterval": "REUSE_INTERVAL",
"disallowUsernameSubstring": "DISALLOW_USERNAME_SUBSTRING",
}
"ipConfiguration": {
"privateNetwork": "PRIVATE_NETWORK",
"authorizedNetworks": [AUTHORIZED_NETWORKS],
"ipv4Enabled": false,
"enablePrivatePathForGoogleCloudServices": true,
"serverCaMode": "CA_MODE",
"customSubjectAlternativeNames": "DNS_NAMES"
}
}
}
Pour envoyer votre requête, développez l'une des options suivantes :
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": "2019-09-25T22:19:33.735Z",
"operationType": "CREATE",
"name": "OPERATION_ID",
"targetId": "INSTANCE_ID",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
"targetProject": "PROJECT_ID"
}
La réponse est une opération de longue durée qui peut prendre quelques minutes.
Mettre à jour le mot de passe racine
Une fois l'initialisation de l'instance terminée, mettez à jour le mot de passe racine :
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
Méthode HTTP et URL :
PUT https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/users?host=%25&name=root
Corps JSON de la requête :
{
"name": "root",
"host": "%",
"password": "root-password"
}
Pour envoyer votre requête, développez l'une des options suivantes :
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": "DONE",
"user": "user@example.com",
"insertTime": "2019-09-26T14:32:30.592Z",
"startTime": "2019-09-26T14:32:30.594Z",
"endTime": "2019-09-26T14:32:33.518Z",
"operationType": "UPDATE_USER",
"name": "operation-id",
"targetId": "instance-id",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
"targetProject": "project-id"
}
La réponse est une opération de longue durée qui peut prendre quelques minutes.
Récupérer l'adresse IPv4
Récupérez l'adresse IPv4 attribuée automatiquement pour la nouvelle instance :
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
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 :
Vous devriez recevoir une réponse JSON de ce type :
{
"kind": "sql#instance",
"state": "RUNNABLE",
"databaseVersion": "MYSQL_8_0_18",
"settings": {
"authorizedGaeApplications": [],
"tier": "db-f1-micro",
"kind": "sql#settings",
"pricingPlan": "PER_USE",
"replicationType": "SYNCHRONOUS",
"activationPolicy": "ALWAYS",
"ipConfiguration": {
"authorizedNetworks": [],
"ipv4Enabled": true
},
"locationPreference": {
"zone": "us-west1-a",
"kind": "sql#locationPreference"
},
"dataDiskType": "PD_SSD",
"backupConfiguration": {
"startTime": "18:00",
"kind": "sql#backupConfiguration",
"enabled": true,
"binaryLogEnabled": true
},
"settingsVersion": "1",
"storageAutoResizeLimit": "0",
"storageAutoResize": true,
"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": "SECOND_GEN",
"selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
"connectionName": "project-id:region:instance-id",
"name": "instance-id",
"region": "us-west1",
"gceZone": "us-west1-a"
}
Recherchez le champ ipAddress dans la réponse.
Générer le point de terminaison d'écriture
Si vous prévoyez de créer une instance Cloud SQL Enterprise Plus et que vous souhaitez que Cloud SQL génère automatiquement un point de terminaison d'écriture pour cette instance, activez l'API Cloud DNS pour votre Google Cloud projet.
Si vous disposez déjà d'une instance Cloud SQL Enterprise Plus et que vous souhaitez que Cloud SQL génère automatiquement un point de terminaison d'écriture, créez une instance répliquée qui gère la reprise après sinistre avancée.
Un point de terminaison d'écriture est un nom de service de nom de domaine (DNS) mondial qui pointe automatiquement vers l'adresse IP de l'instance principale actuelle. Ce point de terminaison redirige automatiquement les connexions entrantes vers la nouvelle instance principale en cas d'opération de basculement d'instance répliquée ou de commutation. Vous pouvez utiliser le point de terminaison d'écriture dans une chaîne de connexion SQL au lieu d'une adresse IP. En utilisant un point de terminaison d'écriture, vous pouvez éviter d'avoir à modifier la connexion de l'application en cas de panne régionale.
Pour en savoir plus sur l'obtention du point de terminaison d'écriture de l'instance, consultez la section Afficher les informations sur l'instance. Pour en savoir plus sur l'utilisation du point de terminaison d'écriture pour vous connecter à l'instance, consultez la section Se connecter à l'aide d'un point de terminaison d'écriture.
Spécifier la version mineure de la base de données pour MySQL 8.0
Vous pouvez spécifier la version mineure d'une instance MySQL 8.0 existante à l'aide de gcloud ou de l'API REST.
gcloud
Exécutez la commande gcloud sql instances create avec l'option --database-version.
Remplacez les variables suivantes avant d'exécuter la commande :
gcloud sql instances create INSTANCE_NAME \ --database-version=DATABASE_VERSION
Pour en savoir plus, consultez la documentation sur la création d'une instance à l'aide de gcloud.
REST v1
Exécutez une requête POST avec la méthode
instances:insert et l'option databaseVersion.
POST https://sqladmin.googleapis.com/v1/projects/project-id/instances
Pour en savoir plus, consultez la documentation sur la création d'une instance à l'aide de l'API REST v1.
REST v1beta4
Exécutez une requête POST avec la méthode
instances:insert et l'option databaseVersion.
POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances
Avant d'utiliser les données de requête ci-dessous, remplacez les variables suivantes :
Pour en savoir plus, consultez la documentation sur la création d'une instance à l'aide de l'API REST v1beta4.
Version mineure de la base de données pour les instances dupliquées avec accès en lecture, les clones et la récupération PITR
Lorsque vous créez une instance dupliquée avec accès en lecture, vous pouvez spécifier la version mineure de la base de données de l'instance dupliquée. Par défaut, les nouvelles instances dupliquées avec accès en lecture sont créées avec la version mineure par défaut.
Lors du clonage d'une instance, l'instance nouvellement créée possède la même version mineure que la source.
Lors d'une récupération à un moment précis, l'instance nouvellement créée possède la même version mineure de base de données que la source.
Configurations d'instances personnalisées
Détermine la mémoire et les cœurs virtuels disponibles pour votre instance Cloud SQL. Les types de machines font partie d'une série de machines, et la disponibilité des séries de machines dépend de votre édition Cloud SQL.
Pour les instances Cloud SQL Enterprise Plus, Cloud SQL propose des types de machines prédéfinis pour vos instances dans les séries de machines N2 et C4A.
Pour les instances Cloud SQL Enterprise, Cloud SQL propose des types de machines prédéfinis et personnalisés.
Si vous avez besoin d'un traitement en temps réel, comme le traitement des transactions en ligne (OLTP), assurez-vous que votre instance dispose de suffisamment de mémoire pour contenir l'ensemble de travail complet. Toutefois, d'autres facteurs peuvent avoir une incidence sur l'utilisation de la mémoire, tels que le nombre de connexions actives et les processus internes. Effectuez des tests de charge pour éviter les problèmes de performances dans votre environnement de production.
Lorsque vous configurez votre instance, sélectionnez suffisamment de mémoire et de vCPU pour répondre à vos besoins, et faites évoluer votre instance à mesure que vos exigences augmentent. Une configuration de machine disposant d'un nombre insuffisant de vCPU risque de ne plus être couverte par son contrat de niveau de service. Pour en savoir plus, consultez la section Consignes opérationnelles.
Pour en savoir plus sur les types et les séries de machines disponibles pour votre instance Cloud SQL, consultez la section Présentation des séries de machines.
Résoudre les problèmes
| Problème | Dépannage |
|---|---|
Message d'erreur : Failed to create subnetwork. Couldn't
find free blocks in allocated IP ranges. Please allocate new ranges for
this service provider. |
Il n'y a plus d'adresses disponibles dans la plage d'adresses IP allouée. Plusieurs scénarios sont possibles :
Pour résoudre ce problème, vous pouvez étendre la plage d'adresses IP allouée existante ou allouer une plage d'adresses IP supplémentaire à la connexion de service privée. Pour plus d'informations, consultez la section Allouer une plage d'adresses IP. Si vous avez utilisé l'option Si vous allouez une nouvelle plage, assurez-vous que l'allocation ne chevauche aucune allocation existante. Après avoir créé une nouvelle plage d'adresses IP, mettez à jour l'appairage de VPC à l'aide de la commande suivante : gcloud services vpc-peerings update \ --service=servicenetworking.googleapis.com \ --ranges=OLD_RESERVED_RANGE_NAME,NEW_RESERVED_RANGE_NAME \ --network=VPC_NETWORK \ --project=PROJECT_ID \ --force Si vous développez une allocation existante, veillez à effectuer uniquement une opération d'augmentation de la plage d'allocation et non à la réduire. Par exemple, si l'allocation d'origine était 10.0.10.0/24, la nouvelle allocation doit être définie au mininmum sur 10.0.10.0/23. En règle générale, si vous commencez par utiliser une allocation /24, il est conseillé de réduire le /masque d'une unité pour chaque condition (groupe de type d'instances supplémentaire, région supplémentaire). Par exemple, si vous essayez de créer les deux groupes de types d'instances sur la même allocation, passer de /24 à /23 est suffisant. Après avoir étendu une plage d'adresses IP existante, mettez à jour l'appairage de VPC à l'aide de la commande suivante : gcloud services vpc-peerings update \ --service=servicenetworking.googleapis.com \ --ranges=RESERVED_RANGE_NAME \ --network=VPC_NETWORK \ --project=PROJECT_ID |
Message d'erreur : Failed to create subnetwork. Router status is
temporarily unavailable. Please try again later. Help Token:
[token-ID]. |
Essayez de créer à nouveau l'instance Cloud SQL. |
Message d'erreur : HTTPError 400: Invalid request: Incorrect Service Networking config for instance: PROJECT_ID:INSTANCE_NAME:SERVICE_NETWORKING_NOT_ENABLED. |
Activez l'API Service Networking à l'aide de la commande suivante, puis essayez de créer à nouveau l'instance Cloud SQL. gcloud services enable servicenetworking.googleapis.com \ --project=PROJECT_ID |
Message d'erreur : Failed to create subnetwork. Required
'compute.projects.get' permission for PROJECT_ID. |
Lorsque vous créez une instance à l'aide d'une adresse IP privée, un compte de service est créé avec le juste-à-temps à l'aide de l'API Service Networking. Si vous avez activé l'API Service Networking récemment, le compte de service peut ne pas être créé et la création de l'instance échoue. Dans ce cas, vous devez attendre que le compte de service se propage dans le système ou l'ajouter manuellement avec les autorisations requises. |
Message d'erreur : More than 3 subject alternative names are not
allowed. |
Vous essayez d'utiliser un SAN personnalisé pour ajouter plus de trois noms DNS au certificat de serveur d'une instance Cloud SQL. Vous ne pouvez pas ajouter plus de trois noms DNS à l'instance. |
Message d'erreur : Subject alternative names %s is too long. The
maximum length is 253 characters. |
Assurez-vous que les noms DNS que vous souhaitez ajouter au certificat de serveur d'une instance Cloud SQL ne comportent pas plus de 253 caractères. |
Message d'erreur : Subject alternative name %s is invalid. |
Vérifiez que les noms DNS que vous souhaitez ajouter au certificat de serveur d'une instance Cloud SQL répondent aux critères suivants: |