Routage tenant compte du leader

Cette page décrit le routage optimisé vers la région responsable dans Spanner et comment l'utiliser. Spanner utilise le routage optimisé vers la région responsable pour acheminer dynamiquement les transactions en lecture-écriture dans les configurations d'instance birégionales et multirégionales afin de réduire la latence et d'améliorer les performances de votre base de données. Le routage optimisé vers la région responsable est activé par défaut.

Routage Spanner pour les transactions en lecture-écriture

Spanner réplique les données pour offrir une disponibilité des données et une localité géographique supplémentaires. Dans les configurations d'instance birégionales et multirégionales Spanner , une région dans la configuration d'instance birégionale et multirégionale est désignée comme région principale et contient les instances répliquées principales de la base de données. Lorsque vous utilisez une configuration d'instance birégionale ou multirégionale et que votre client émet une transaction en lecture-écriture dans votre base de données à partir d'une région non principale, l'écriture est toujours traitée dans la région principale, puis renvoyée à la région non principale. Par conséquent, les transactions en lecture-écriture validées à partir d'une région non principale nécessitent plusieurs allers-retours vers l'instance répliquée principale pour être validées.

Le routage optimisé vers la région responsable est un mécanisme qui améliore la latence des transactions en lecture-écriture en les acheminant de manière intelligente. Si le routage optimisé vers la région responsable est activé, même si l'écriture ne provient pas de la région principale, les requêtes de création de session sont acheminées vers la région principale pour aligner l'interface de l'API Spanner sur la région principale. Ce mécanisme de routage améliore la latence des transactions en lecture-écriture en réduisant à deux le nombre d'allers-retours réseau requis entre la région non principale (où se trouve l'application cliente) et la région principale.

Capture d'écran du routage Spanner avec le routage tenant compte du leader activé. Figure 1. Exemple de routage Spanner avec le routage optimisé vers la région responsable activé.

Si le routage optimisé vers la région responsable est désactivé, l'application cliente achemine d'abord la requête vers un service d'interface de l'API Spanner dans la région de l'application cliente (région non principale). Ensuite, à partir de l'interface de l'API Spanner dans la région de l'application cliente, trois allers-retours ou plus sont effectués vers le serveur Spanner (SpanServer) dans la région principale pour valider l'écriture, ce qui augmente la latence. Ces allers-retours supplémentaires sont nécessaires pour prendre en charge les index secondaires, les vérifications des contraintes et la lecture de vos écritures.

Capture d'écran du routage Spanner avec le routage tenant compte du leader désactivé. Figure 2. Exemple de routage Spanner avec le routage optimisé vers la région responsable désactivé.

Cas d'utilisation

Grâce au routage optimisé vers la région responsable, les cas d'utilisation suivants bénéficient d'une latence plus faible :

  • Mises à jour groupées : exécution d'importations Dataflow ou exécution de modifications en arrière-plan (par exemple, des LMD par lot) à partir d'une région non principale.
  • Tolérance aux pannes et disponibilité accrue : déploiement d'applications clientes dans les régions principales et non principales pour tolérer les pannes régionales tout en initiant des écritures à partir de régions non principales.
  • Application globale : déploiement d'applications clientes à l'échelle mondiale avec des emplacements régionaux étendus qui valident les données.

Limites

Si votre application cliente est déployée en dehors de la région principale et que vous écrivez des valeurs sans lire les données ("écritures aveugles"), vous pouvez observer une régression de la latence si le routage optimisé vers la région responsable est activé. En effet, lorsque le routage optimisé vers la région responsable est activé, il existe deux allers-retours interrégionaux (beginTransaction et la requête commit) entre l'application cliente dans la région non principale et l'interface de l'API Spanner dans la région principale. Toutefois, lorsque le routage optimisé vers la région responsable est désactivé, les écritures sans lectures ne nécessitent qu'un seul aller-retour interrégional pour la requête commit (beginTransaction est traité dans l'interface de l'API Spanner locale). Par exemple, si vous chargez des données en bloc dans une table nouvellement créée, il est peu probable que les transactions lisent des données dans la table. Si vous validez fréquemment des opérations d'écriture sans les lire dans votre application, vous pouvez envisager de désactiver le routage optimisé vers la région responsable. Pour en savoir plus, consultez Désactiver le routage optimisé vers la région responsable.

Utiliser le routage optimisé vers la région responsable

Le routage optimisé vers la région responsable est activé par défaut dans les bibliothèques clientes Spanner.

Nous vous recommandons de traiter vos requêtes en lecture-écriture avec le routage optimisé vers la région responsable activé. Vous pouvez le désactiver pour comparer les différences de performances.

Activer le routage optimisé vers la région responsable

Vous pouvez utiliser les bibliothèques clientes Spanner pour activer manuellement le routage optimisé vers la région responsable.

C++

Utilisez la RouteToLeaderOption structure pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

void RouteToLeaderOption(std::string const& project_id, std::string const& instance_id,
              std::string const& database_id) {
namespace spanner = ::google::cloud::spanner;

// Create a client with RouteToLeaderOption enabled.
auto client = spanner::Client(
  spanner::MakeConnection(
      spanner::Database(project_id, instance_id, database_id)),
  google::cloud::Options{}.set<spanner::RouteToLeaderOption>(
      spanner::true));

C#

Utilisez EnableLeaderRouting pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

// Create a client with leader-aware routing enabled.
SpannerConnectionStringBuilder builder = new
SpannerConnectionStringBuilder();
Builder.EnableLeaderRouting = true;

Go

Utilisez ClientConfig pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

type ClientConfig struct {
    // DisableRouteToLeader specifies if all the requests of type read-write
    // and PDML need to be routed to the leader region.
    // Default: false
    DisableRouteToLeader false
}

Java

Utilisez SpannerOptions.Builder pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

SpannerOptions options = SpannerOptions.newBuilder().enableLeaderAwareRouting.build();
Spanner spanner = options.getService();
String instance = "my-instance";
String database = "my-database";

Node.js

Utilisez SpannerOptions pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

// Instantiates a client with routeToLeaderEnabled enabled
const spanner = new Spanner({
projectId: projectId,
routeToLeaderEnabled: true;
});

PHP

Utilisez routeToLeader pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

// Instantiates a client with leader-aware routing enabled
use Google\Cloud\Spanner\SpannerClient;

$routeToLeader = true;
$spanner = new SpannerClient($routeToLeader);

Python

Utilisez route_to_leader_enabled pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

spanner_client = spanner.Client(
route_to_leader_enabled=true
)
instance = spanner_client.instance(instance_id)
database = instance.database(database_id)

Ruby

Utilisez self.new pour configurer votre application cliente avec le routage optimisé vers la région responsable activé :

def self.new(project_id: nil, credentials: nil, scope: nil, timeout: nil,
     endpoint: nil, project: nil, keyfile: nil, emulator_host: nil,
    lib_name: nil, lib_version: nil, enable_leader_aware_routing: true) ->
    Google::Cloud::Spanner::Project

Désactiver le routage optimisé vers la région responsable

Vous pouvez utiliser les bibliothèques clientes Spanner pour désactiver le routage optimisé vers la région responsable.

C++

Utilisez la RouteToLeaderOption structure pour configurer votre application cliente avec le routage optimisé vers la région responsable désactivé :

void RouteToLeaderOption(std::string const& project_id, std::string const& instance_id,
              std::string const& database_id) {
namespace spanner = ::google::cloud::spanner;

// Create a client with RouteToLeaderOption disabled.
auto client = spanner::Client(
  spanner::MakeConnection(
      spanner::Database(project_id, instance_id, database_id)),
  google::cloud::Options{}.set<spanner::RouteToLeaderOption>(
      spanner::false));

C#

Utilisez EnableLeaderRouting pour configurer votre application cliente avec le routage optimisé vers la région responsable désactivé :

// Create a client with leader-aware routing disabled.
SpannerConnectionStringBuilder builder = new
SpannerConnectionStringBuilder();
Builder.EnableLeaderRouting = false;

Go

Utilisez ClientConfig pour configurer votre application cliente avec le routage optimisé vers la région responsable désactivé :

type ClientConfig struct {
    // DisableRouteToLeader specifies if all the requests of type read-write
    // and PDML need to be routed to the leader region.
    // Default: false
    DisableRouteToLeader true
}

Java

Utilisez SpannerOptions.Builder pour créer une connexion à une base de données Spanner avec le routage optimisé vers la région responsable désactivé :

SpannerOptions options = SpannerOptions.newBuilder().disableLeaderAwareRouting.build();
Spanner spanner = options.getService();
String instance = "my-instance";
String database = "my-database";

Node.js

Utilisez SpannerOptions pour configurer votre application cliente avec le routage optimisé vers la région responsable désactivé :

// Instantiates a client with routeToLeaderEnabled disabled
const spanner = new Spanner({
projectId: projectId,
routeToLeaderEnabled: false;
});

PHP

Utilisez routeToLeader pour configurer votre application cliente avec le routage optimisé vers la région responsable désactivé :

// Instantiates a client with leader-aware routing disabled
use Google\Cloud\Spanner\SpannerClient;

$routeToLeader = false;
$spanner = new SpannerClient($routeToLeader);

Python

Utilisez route_to_leader_enabled pour configurer votre application cliente avec le routage optimisé vers la région responsable désactivé :

spanner_client = spanner.Client(
route_to_leader_enabled=false
)
instance = spanner_client.instance(instance_id)
database = instance.database(database_id)

Ruby

Utilisez self.new pour configurer votre application cliente avec le routage optimisé vers la région responsable désactivé :

def self.new(project_id: nil, credentials: nil, scope: nil, timeout: nil,
     endpoint: nil, project: nil, keyfile: nil, emulator_host: nil,
    lib_name: nil, lib_version: nil, enable_leader_aware_routing: false) ->
    Google::Cloud::Spanner::Project

Étape suivante