Cette page a été traduite par l'API Cloud Translation.

Créer et gérer des partitions

Cette page explique comment créer et gérer des partitions Spanner.

Avant de commencer

Pour utiliser des partitions, vous devez définir l'option de base de données opt_in_dataplacement_preview dans votre base de données vide :

Console

Accédez à la page Instances dans la console Google Cloud.

Instances
Sélectionnez l'instance à laquelle vous souhaitez ajouter des partitions.
Sélectionnez la base de données vide dans laquelle 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 le champ vide de l'éditeur.
Saisissez l'instruction DDL ALTER DATABASE suivante.
```
ALTER DATABASE DATABASE_ID SET OPTIONS (opt_in_dataplacement_preview = true);
```
Remplacez DATABASE_ID par l'identifiant unique de votre base de données.
Cliquez sur Exécuter.

gcloud

Pour définir l'option de base de données opt_in_dataplacement_preview, utilisez gcloud spanner databases ddl update.

gcloud spanner databases ddl update DATABASE_ID \
  --instance=INSTANCE_ID \
  --ddl="ALTER DATABASE db SET OPTIONS (opt_in_dataplacement_preview = true);"

Remplacez les éléments suivants :

DATABASE_ID: identifiant permanent de votre instance Spanner base de données.
INSTANCE_ID : identifiant permanent de votre instance Spanner.

Créer une partition

Console

Dans la console Google Cloud, ouvrez la page Spanner.

Accéder à Spanner
Sélectionnez l'instance à laquelle vous souhaitez ajouter des partitions.
Dans le menu de navigation, sélectionnez Partitions.
Cliquez sur Créer une partition.
Saisissez un ID de partition pour identifier votre partition de manière permanente. L'ID de partition doit également être unique dans votre projet Google Cloud. Vous ne pourrez pas modifier l'ID de partition par la suite.
Dans la section Sélectionner une configuration, sélectionnez Régional ou Multirégional. Si vous souhaitez comparer les spécifications régions, puis cliquez sur Comparer les configurations régionales.
Sélectionnez une configuration dans le menu déroulant.
Dans la section Allouer de la capacité de calcul, sous Unité, cliquez sur l'une des options suivantes :
- Unités de traitement pour les petites partitions d'instances.
- Nœuds pour les instances volumineuses Un nœud correspond à 1 000 unités de traitement.
Saisissez une valeur pour l'unité sélectionnée.

Votre partition doit comporter au moins un nœud ou 1 000 unités de traitement.
Cliquez sur Créer pour créer la partition.

gcloud

Pour créer une partition, utilisez gcloud beta spanner instance-partitions create.

gcloud beta spanner instance-partitions create PARTITION_ID \
  --config=PARTITION_CONFIG \
  --description="PARTITION_DESCRIPTION" \
  --instance=INSTANCE_ID \
  [--nodes=NODE_COUNT | --processing-units=PROCESSING_UNIT_COUNT]

Remplacez les éléments suivants :

PARTITION_ID : identifiant de partition permanent unique dans votre projet Google Cloud. Vous ne pourrez pas modifier l'ID de partition par la suite.
PARTITION_CONFIG : identifiant permanent de votre configuration de partition, qui définit l'emplacement géographique de la partition et affecte l'emplacement de stockage des données.
PARTITION_DESCRIPTION: nom à afficher pour la partition. dans la console Google Cloud. Le nom de la partition doit être unique dans votre projet Google Cloud.
INSTANCE_ID: identifiant permanent de votre Instance Spanner sur laquelle réside cette partition.
NODE_COUNT : capacité de calcul de la partition, exprimée en nombre de nœuds. Un nœud correspond à 1 000 unités de traitement.
PROCESSING_UNIT_COUNT : capacité de calcul de l'instance, exprimée en nombre d'unités de traitement. Votre partition doit avoir au au moins 1 000 unités de traitement. Saisissez des quantités par multiples de 1 000 (1 000, 2 000, 3 000, etc.).

Par exemple, pour créer une partition europe-partition dans eur3 avec cinq nœuds, exécutez la commande suivante :

  gcloud beta spanner instance-partitions create europe-partition --config=eur3 \
    --description="europe-partition" --instance=test-instance --nodes=5

C++

Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.

void CreateInstancePartition(
    google::cloud::spanner_admin::InstanceAdminClient client,
    std::string const& project_id, std::string const& instance_id,
    std::string const& instance_partition_id) {
  auto project = google::cloud::Project(project_id);
  auto in = google::cloud::spanner::Instance(project_id, instance_id);
  auto config = project.FullName() + "/instanceConfigs/nam3";

  google::spanner::admin::instance::v1::CreateInstancePartitionRequest request;
  request.set_parent(in.FullName());
  request.set_instance_partition_id(instance_partition_id);
  request.mutable_instance_partition()->set_display_name(
      "Test instance partition");
  request.mutable_instance_partition()->set_node_count(1);
  request.mutable_instance_partition()->set_config(config);

  auto instance_partition = client.CreateInstancePartition(request).get();
  if (!instance_partition) throw std::move(instance_partition).status();
  std::cout << "Created instance partition [" << instance_partition_id << "]:\n"
            << instance_partition->DebugString();
}

C#

Pour savoir comment installer et utiliser la bibliothèque cliente pour Spanner, consultez la page Bibliothèques clientes Spanner.


using Google.Cloud.Spanner.Admin.Instance.V1;
using Google.Cloud.Spanner.Common.V1;
using Google.LongRunning;
using System;

public class CreateInstancePartitionSample
{
    public InstancePartition CreateInstancePartition(string projectId, string instanceId, string instancePartitionId)
    {
        // Create the InstanceAdminClient instance.
        InstanceAdminClient instanceAdminClient = InstanceAdminClient.Create();

        // Initialize request parameters.
        InstancePartition partition = new InstancePartition
        {
            DisplayName = "This is a display name.",
            NodeCount = 1,
            ConfigAsInstanceConfigName = InstanceConfigName.FromProjectInstanceConfig(projectId, "nam3"),
        };
        InstanceName instanceName = InstanceName.FromProjectInstance(projectId, instanceId);

        // Make the CreateInstancePartition request.
        Operation<InstancePartition, CreateInstancePartitionMetadata> response = instanceAdminClient.CreateInstancePartition(instanceName, partition, instancePartitionId);

        Console.WriteLine("Waiting for the operation to finish.");

        // Poll until the returned long-running operation is complete.
        Operation<InstancePartition, CreateInstancePartitionMetadata> completedResponse = response.PollUntilCompleted();

        if (completedResponse.IsFaulted)
        {
            Console.WriteLine($"Error while creating instance partition: {completedResponse.Exception}");
            throw completedResponse.Exception;
        }

        Console.WriteLine($"Instance created successfully.");

        return completedResponse.Result;
    }
}