Cette page explique comment créer et gérer des emplacements de données dans Spanner.
Pour en savoir plus sur le fonctionnement du partitionnement géographique, consultez la présentation du partitionnement géographique.
Gérer les métadonnées de routage
Lorsque votre application doit lire ou écrire des données, Spanner utilise des métadonnées de routage pour identifier les serveurs qui contiennent les lignes spécifiques nécessaires.
Le choix de l'emplacement des métadonnées de routage dépend de la nature des requêtes des clients (la plupart concernent-elles des données situées dans la même région ou en dehors de la région ?) et de l'utilisation ou non d'une configuration multirégionale. Les paramètres de métadonnées de routage ont une incidence sur la latence et ne peuvent pas être modifiés après la création des emplacements.
L'option per_placement_routing_metadata détermine l'emplacement des métadonnées de routage en fonction des paramètres suivants :
TRUE: si la valeur est définie surTRUE, les métadonnées de routage résident dans la même partition d'instance que les données. Les métadonnées de routage sont segmentées par région. Cela réduit la latence des requêtes de données dans la région (c'est-à-dire que le client et les données utilisateur demandées se trouvent dans la même région), de sorte que Spanner n'a pas besoin d'effectuer d'appels hors région pour le routage des métadonnées. Toutefois, ce paramètre peut augmenter la latence des requêtes hors région, des recherches négatives où les lignes d'emplacement n'existent pas et des requêtes nécessitant un index global.Nous recommandons ce paramètre si vous prévoyez que la plupart des requêtes seront effectuées pour des données utilisateur dans la même région que le client, et que votre partition par défaut ne comporte pas de régions en lecture-écriture ou en lecture seule colocalisées avec toutes les partitions de votre instance.
FALSE: les métadonnées de routage sont centralisées dans la partition par défaut.Nous vous recommandons ce paramètre si vous vous attendez à ce que les clients recherchent fréquemment des données hors de leur région, par exemple un client de la région UE qui recherche des données pour des utilisateurs aux États-Unis.
Envisagez également ce paramètre si la partition d'instance par défaut utilise une configuration multirégionale qui fournit des régions en lecture-écriture ou en lecture seule colocalisées avec toutes vos partitions d'instance. Avec ce paramètre, une instance répliquée des métadonnées de routage complètes est stockée avec chaque instance répliquée de la partition d'instance par défaut. Par conséquent, toutes les régions disposant de partitions d'instances possèdent une instance répliquée des métadonnées de routage. Cela permet aux requêtes intra-régionales et extra-régionales de rechercher des métadonnées de routage localement.
Définir l'option per_placement_routing_metadata
L'option per_placement_routing_metadata accepte les valeurs booléennes. Si cette option est définie sur TRUE, les métadonnées de routage résident dans la même partition d'instance que les données. Si la valeur est FALSE, les métadonnées de routage résident dans la partition d'instance par défaut.
Pour définir l'option per_placement_routing_metadata, mettez à jour le schéma de votre base de données.
Pour en savoir plus sur les autres méthodes de mise à jour d'un schéma, telles que les bibliothèques clientes ou les API REST et RPC, consultez Mettre à jour un schéma.
Sélectionnez l'une des options suivantes :
Console
Dans la console Google Cloud , accédez à la page Instances.
Sélectionnez l'instance avec des partitions d'instance créées par l'utilisateur.
Sélectionnez la base de données dans laquelle vous souhaitez définir les métadonnées de routage.
Dans le menu de navigation, cliquez sur Spanner Studio.
Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Saisissez l'instruction LDD
ALTER DATABASE(GoogleSQL, PostgreSQL) :GoogleSQL
ALTER DATABASE `DATABASE_NAME` SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN);Remplacez les éléments suivants :
DATABASE_NAME: nom de votre base de données.METADATA_BOOLEAN: valeur pourper_placement_routing_metadata. Si la valeur estTRUE, les métadonnées de routage résident dans la même partition d'instance que les données. SiFALSE, les métadonnées de routage résident dans la partition d'instance par défaut.
PostgreSQL
ALTER DATABASE "DATABASE_NAME" SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN;Remplacez les éléments suivants :
DATABASE_NAME: nom de votre base de données.METADATA_BOOLEAN: valeur pourper_placement_routing_metadata. Si la valeur estTRUE, les métadonnées de routage résident dans la même partition d'instance que les données. Si la valeur estFALSE, les métadonnées de routage résident dans la partition d'instance par défaut.
Cliquez sur Exécuter.
gcloud
Pour définir l'option per_placement_routing_metadata avec la Google Cloud CLI, utilisez gcloud spanner databases ddl update :
GoogleSQL
gcloud spanner databases ddl update DATABASE_NAME \
--instance=INSTANCE_ID \
--ddl='ALTER DATABASE `DATABASE_NAME`
SET OPTIONS (per_placement_routing_metadata = METADATA_BOOLEAN)'
Remplacez les éléments suivants :
DATABASE_NAME: nom de votre base de données.INSTANCE_ID: ID de votre instance Spanner.METADATA_BOOLEAN: valeur pourper_placement_routing_metadata. Si la valeur estTRUE, les métadonnées de routage résident dans la même partition d'instance que les données. Si la valeur estFALSE, les métadonnées de routage résident dans la partition d'instance par défaut.
PostgreSQL
gcloud spanner databases ddl update DATABASE_NAME \
--instance=INSTANCE_ID \
--ddl='ALTER DATABASE "DATABASE_NAME"
SET spanner.per_placement_routing_metadata = METADATA_BOOLEAN'
Remplacez les éléments suivants :
DATABASE_NAME: nom de votre base de données.INSTANCE_ID: ID de votre instance Spanner.METADATA_BOOLEAN: valeur pourper_placement_routing_metadata. Si la valeur estTRUE, les métadonnées de routage résident dans la même partition d'instance que les données. SiFALSE, les métadonnées de routage résident dans la partition d'instance par défaut.
Créer un emplacement de données
Après avoir créé vos partitions d'instance Spanner et vos bases de données, et défini l'option per_placement_routing_metadata, créez votre emplacement.
Console
Accédez à la page Instances de la console Google Cloud .
Sélectionnez l'instance contenant une ou plusieurs partitions d'instance créées par l'utilisateur.
Sélectionnez la base de données dont vous souhaitez partitionner les données.
Dans le menu de navigation, cliquez sur Spanner Studio.
Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Saisissez l'instruction LDD
CREATE PLACEMENT(GoogleSQL, PostgreSQL).Par exemple, vous pouvez exécuter la commande suivante pour créer une table d'emplacement
europeplacementdans la partition d'instanceeurope-partition:GoogleSQL
CREATE PLACEMENT europeplacement OPTIONS (instance_partition="europe-partition");PostgreSQL
CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition');Facultatif : Vous pouvez également utiliser le volet Explorateur d'objets pour afficher vos objets Placement, effectuer des recherches et interagir avec eux. Pour en savoir plus, consultez Explorer vos données.
Cliquez sur Exécuter.
gcloud
Pour créer un emplacement avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.
Par exemple, créez un emplacement dans la partition d'instance europe-partition :
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement OPTIONS (instance_partition='europe-partition')"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT europeplacement WITH (instance_partition='europe-partition')"
Définir l'annonce principale par défaut pour un emplacement
Vous pouvez définir la région principale par défaut d'un emplacement si celui-ci se trouve dans un emplacement multirégional. La nouvelle région principale doit être l'une des deux régions de lecture/écriture de l'emplacement multirégional. Pour en savoir plus, consultez les tableaux Configurations multirégionales disponibles.
Si vous ne définissez pas de région principale, votre emplacement utilise la région principale par défaut, comme spécifié par son emplacement. Pour obtenir la liste des régions principales pour chaque emplacement multirégional, consultez les tableaux Configurations multirégionales disponibles. La région principale par défaut est indiquée par un L. Par exemple, la région leader par défaut de nam8 est Los Angeles (us-west2). Les instructions suivantes expliquent comment la définir sur Oregon (us-west1).
Console
Accédez à la page Instances de la console Google Cloud .
Sélectionnez l'instance contenant une ou plusieurs partitions d'instance créées par l'utilisateur.
Sélectionnez la base de données dont vous souhaitez partitionner les données.
Dans le menu de navigation, cliquez sur Spanner Studio.
Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Saisissez l'instruction LDD
CREATE PLACEMENT(GoogleSQL, PostgreSQL).Par exemple, vous pouvez exécuter la commande suivante pour créer une table d'emplacement
nam8placementdans la partition d'instancenam8-partitionavec l'emplacement du leader par défaut défini surus-west1:GoogleSQL
CREATE PLACEMENT `nam8placement` OPTIONS (instance_partition="nam8-partition", default_leader="us-west1");PostgreSQL
CREATE PLACEMENT nam8placement WITH (instance_partition='nam8-partition', default_leader='us-west1');Facultatif : Vous pouvez également utiliser le volet Explorateur d'objets pour afficher vos objets Placement, effectuer des recherches et interagir avec eux. Pour en savoir plus, consultez Explorer vos données.
Cliquez sur Exécuter.
gcloud
Pour créer un emplacement avec la commande gcloud CLI, utilisez gcloud spanner databases ddl update.
Par exemple, créez une table d'emplacement nam8placement dans la partition d'instance nam8-partition avec l'emplacement du leader par défaut défini sur us-west1 :
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT nam8placement \
OPTIONS (instance_partition='nam8-partition', default_leader='us-west1')"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE PLACEMENT nam8placement WITH (instance_partition='nam8-partition', default_leader='us-west1')"
Supprimer un emplacement de données
Avant de supprimer un emplacement, vous devez supprimer toutes les données de ligne de l'emplacement. Une fois cette opération effectuée, vous pouvez utiliser la console Google Cloud ou gcloud CLI pour supprimer l'emplacement.
Console
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Saisissez l'instruction LDD
DROP PLACEMENT(GoogleSQL, PostgreSQL).Par exemple, vous pouvez exécuter la commande suivante pour supprimer la table de placement
europeplacement:GoogleSQL
DROP PLACEMENT europeplacement;PostgreSQL
DROP PLACEMENT europeplacement;
gcloud
Pour supprimer un emplacement à l'aide de la commande gcloud CLI, utilisez gcloud spanner databases ddl update.
Par exemple, l'emplacement de dépôt europeplacement :
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="DROP PLACEMENT europeplacement"
Erreurs de placement des éléments déposés
Si l'emplacement est utilisé, l'opération DROP PLACEMENT échoue avec un message d'erreur tel que : "Échec de l'instruction : l'emplacement PLACEMENT_NAME ne peut pas être supprimé, car il est utilisé par la table d'emplacement PLACEMENT_TABLE_NAME". Si vous rencontrez cette erreur, procédez comme suit :
- Modifiez votre application pour arrêter d'insérer ou de mettre à jour des lignes avec l'emplacement que vous souhaitez supprimer.
L'une des options ci-dessous :
Déplacez les lignes d'emplacement existantes qui utilisent l'emplacement que vous souhaitez supprimer vers un autre emplacement à l'aide d'une instruction LMD partitionnée comme celle-ci :
UPDATE PLACEMENT_TABLE_NAME SET LOCATION = NEW_PLACEMENT_NAME WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;Supprimez les lignes d'emplacement à l'aide d'une instruction LMD partitionnée, comme suit :
DELETE FROM PLACEMENT_TABLE_NAME WHERE LOCATION = ORIGINAL_PLACEMENT_NAME;Les instructions LMD spécifiques à l'emplacement précédentes ne fonctionnent qu'avec le LMD partitionné. Elles échoueront comme des instructions LMD standards. Pour en savoir plus, consultez la section Limites. Vous pouvez également utiliser l'API Mutation pour déplacer ou supprimer des lignes d'emplacement.
Annuler une opération DROP PLACEMENT
Vous pouvez annuler une opération DROP PLACEMENT à tout moment avant que l'opération de longue durée ne supprime complètement l'emplacement du schéma de base de données. Pour savoir comment obtenir l'ID d'une opération de longue durée afin de vérifier son état ou de l'annuler, consultez Gérer et observer les opérations de longue durée.
Créer une table avec une clé d'emplacement
Console
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Saisissez l'instruction LDD
CREATE TABLE(GoogleSQL, PostgreSQL).Par exemple, vous pouvez créer une table
Singersqui utilise une clé d'emplacement pour partitionner les données des chanteurs :GoogleSQL
CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, ... Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);PostgreSQL
CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), ... Location varchar(1024) NOT NULL PLACEMENT KEY );
gcloud
Pour créer une table, utilisez gcloud spanner databases ddl update.
Par exemple, vous pouvez créer une table Singers qui utilise une clé d'emplacement pour partitionner les données des chanteurs :
GoogleSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId INT64 NOT NULL, SingerName STRING(MAX) NOT NULL, Location STRING(MAX) NOT NULL PLACEMENT KEY ) PRIMARY KEY (SingerId);"
PostgreSQL
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="CREATE TABLE Singers ( SingerId bigint PRIMARY KEY, SingerName varchar(1024), Location varchar(1024) NOT NULL PLACEMENT KEY );"
Modifier un tableau avec une clé d'emplacement
Vous ne pouvez pas supprimer une clé d'emplacement d'une table. Vous ne pouvez pas non plus ajouter de clé d'emplacement à une table après sa création. Toutefois, vous pouvez utiliser l'instruction LDD ALTER TABLE (GoogleSQL, PostgreSQL) pour modifier d'autres champs de la table, par exemple en ajoutant et en supprimant des colonnes de clé sans emplacement.
Supprimer une table avec une clé d'emplacement
Avant de supprimer une table avec une clé d'emplacement, vous devez d'abord :
- Supprimez toutes les lignes du tableau des emplacements.
- Attendez que le
version_retention_periodde la base de données soit écoulé. Pour en savoir plus, consultez Récupération à un moment précis. Ensuite, procédez comme suit :
Console
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Saisissez l'instruction LDD
DROP TABLE(GoogleSQL, PostgreSQL).Par exemple, supprimez la table
Singers:DROP TABLE Singers;
gcloud
Pour supprimer une table, utilisez gcloud spanner databases ddl update.
Par exemple, supprimez la table Singers :
gcloud spanner databases ddl update example-db \
--instance=test-instance \
--ddl="DROP TABLE Singers"
Insérer une ligne dans un tableau d'emplacement
Console
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Saisissez l'instruction LDD
INSERT INTO(GoogleSQL, PostgreSQL).Par exemple, ajoutez un chanteur, Marc Richards, à la table
Singerset partitionnez-le danseuropeplacement:INSERT INTO Singers(SingerId, SingerName, Location) VALUES (1, 'Marc Richards', 'europeplacement')
gcloud
Pour écrire des données dans une table, utilisez gcloud spanner rows insert.
Par exemple, ajoutez un chanteur, Marc Richards, à la table Singers et partitionnez-le dans europeplacement :
gcloud spanner rows insert --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Marc Richards',Location='europeplacement'
Mettre à jour une ligne dans un tableau d'emplacements
Console
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Utilisez le DML ou des mutations pour mettre à jour les données d'une table d'emplacement.
Par exemple, remplacez le nom de
singerid=1dans la tableSingersparCatalina Smith:UPDATE Singers s SET s.name='Catalina Smith' WHERE s.id=1;
gcloud
Pour mettre à jour les données d'une table d'emplacement, utilisez gcloud spanner rows update.
Par exemple, remplacez le nom de singerid=1 dans la table Singers par Catalina Smith :
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,SingerName='Catalina Smith'
Déplacer une ligne dans un tableau d'emplacements
Console
- Créez une partition d'instance et un emplacement si vous ne l'avez pas déjà fait.
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Utilisez le DML ou des mutations pour déplacer les données vers la nouvelle partition d'instance.
Par exemple, déplacez
singerid=1dans la tableSingersversasiaplacement:UPDATE Singers s SET s.location='asiaplacement' WHERE s.id=1;
gcloud
Après avoir créé la partition d'instance et l'emplacement où vous souhaitez déplacer vos données, utilisez gcloud spanner rows update.
Par exemple, déplacez singerid=1 dans la table Singers vers asiaplacement :
gcloud spanner rows update --table=Singers --database=example-db \
--instance=test-instance --data=SingerId=1,Location='asiaplacement'
Supprimer une ligne dans un tableau d'emplacements
Console
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Utilisez le DML ou des mutations pour supprimer des données.
Par exemple, supprimez
singerid=1dans la tableSingers:DELETE FROM Singers s WHERE s.id=1;
gcloud
Pour supprimer des données, utilisez gcloud spanner rows delete.
Par exemple, supprimez singerid=1 dans la table Singers :
gcloud spanner rows delete --table=Singers --database=example-db \
--instance=test-instance --keys=1
Interroger les données d'une table d'emplacement
Console
- Dans le menu de navigation, cliquez sur Spanner Studio.
- Sur la page Spanner Studio, cliquez sur Nouvel onglet ou utilisez l'onglet d'éditeur vide.
Exécutez votre requête.
Par exemple, interrogez la table
Singers:SELECT * FROM Singers s WHERE s.SingerId=1;
gcloud
Pour interroger des données, utilisez gcloud spanner databases execute-sql.
Par exemple, interrogez la table Singers :
gcloud spanner databases execute-sql example-db \
--instance=test-instance \
--sql='SELECT * FROM Singers s WHERE s.SingerId=1'
Étapes suivantes
En savoir plus sur le partitionnement géographique
Découvrez comment créer et gérer des partitions d'instance.