Auf dieser Seite wird das leiterbasierte Routing in Spanner und seine Verwendung beschrieben. Spanner verwendet Leader-spezifisches Routing für die dynamische Weiterleitung von Lese-/Schreibvorgängen. Transaktionen in Dual- und multiregionalen Instanzkonfigurationen, um und die Leistung Ihrer Datenbank zu verbessern. Führende Routenplanung ist ist standardmäßig aktiviert.
Spanner-Routing für Lese-Schreib-Transaktionen
Spanner repliziert Daten, um zusätzliche Daten bereitzustellen und geografischer Standort. In biregionalen und multiregionalen Instanzkonfigurationen von Spanner wird eine Region als führende Region festgelegt. Sie enthält die Leader-Replikate der Datenbank. Wenn Sie eine Instanz mit zwei oder mehreren Regionen verwenden Konfiguration und Ihr Client gibt eine Lese-Schreib-Transaktion an Ihre Datenbank aus. aus einer nicht führenden Region stammen, wird der Schreibvorgang immer in der führenden Region verarbeitet. und anschließend zurück an die nicht führende Region gesendet. Daher werden Lese-Schreib-Transaktionen aus einer Region führen, die keine führende Lösung ist, erfordern mehrere Umwege zum Führenden. für das Replikat.
Leader-aware Routing ist ein Mechanismus, der die Latenz bei Lese-/Schreibvorgängen verbessert durch intelligentes Routing. Wenn die Führungsebene bekannt ist ist das Routing aktiviert, auch wenn der Schreibvorgang nicht aus der führenden Region stammt. werden die Anfragen zur Sitzungserstellung an die führende Region weitergeleitet, Spanner Front End (SpanFE) mit der führenden Region. Diese Route Der Mechanismus verbessert die Latenz für Lese-Schreib-Transaktionen, indem er die Anzahl der der Netzwerk-Roundtrips zwischen der Region erforderlich sind, in der der Client Anwendung sich befindet) und die führende Region auf zwei.
Abbildung 1. Beispiel für ein Spanner-Routing mit aktiviertem Leader-aware-Routing
Wenn das Leader-spezifische Routing deaktiviert ist, leitet die Clientanwendung zuerst weiter Die Anfrage an einen SpanFE-Dienst in der Region der Clientanwendung (keine führende Region). Anschließend werden vom SpanFE in der Region der Clientanwendung drei oder mehr Rundreisen zum Spanner-Server (SpanServer) in der Leitregion durchgeführt, um den Schreibvorgang zu bestätigen. Dies erhöht die Latenz. Diese zur Unterstützung sekundärer Indexe sind zusätzliche Umläufe erforderlich, Einschränkung prüft und liest Ihre Schreibvorgänge.
Abbildung 2. Beispiel für ein Spanner-Routing mit deaktiviertem Leader-aware-Routing
Anwendungsfälle
Die Verwendung der Leader-gestützten Weiterleitung hat für folgende Anwendungsfälle Vorteile: durch niedrigere Latenz:
- Bulk-Aktualisierungen: Dataflow-Importe ausführen oder Hintergrund ausführen Änderungen (z. B. Batch-DMLs) aus einer Region, die keine führende Lösung ist.
- Notfalltoleranz und erhöhte Verfügbarkeit: Client bereitstellen in führenden und nicht führenden Regionen anwenden, um regionale während Schreibvorgänge aus nicht führenden Regionen initiiert werden.
- Globale Anwendung: Bereitstellung von Clientanwendungen weltweit mit weit verbreiteten Standorten in Regionen, in denen Daten verbindlich festgelegt werden.
Beschränkungen
Wenn Ihre Clientanwendung außerhalb der führenden Region bereitgestellt wird und Sie
Werte schreiben, ohne die Daten zu lesen ("blind Write"), kann es zu Latenzen kommen,
wenn die Leader-spezifische Weiterleitung aktiviert ist. Denn wenn die Führungskraft
Routing ist aktiviert, es gibt zwei interregionale Umläufe (beginTransaction
).
und der commit
-Anfrage) zwischen der Kundenanwendung in der nicht führenden Rolle
und den SpanFE in der führenden Region. Wenn das leader-aware Routing jedoch deaktiviert ist, ist für Schreibvorgänge ohne Lesevorgänge nur eine Umlaufkommunikation zwischen den Regionen für die commit
-Anfrage erforderlich (beginTransaction
wird in der lokalen SpanFE verarbeitet). Für
Wenn Sie beispielsweise Dateidaten im Bulk in eine neu erstellte Tabelle laden, werden die Transaktionen
Es ist unwahrscheinlich, dass Daten aus der Tabelle gelesen werden. Wenn Sie häufig Schreibvorgänge ausführen, ohne sie in Ihrer Anwendung zu lesen, sollten Sie das führerbasierte Routing deaktivieren. Weitere Informationen finden Sie unter
Erkennung des Leaders deaktivieren
Führende Routenplanung verwenden
Leader-aware-Routing ist im Spanner-Client standardmäßig aktiviert Bibliotheken.
Wir empfehlen, Ihre Lese-/Schreibanfragen mit Leader-fähigem Routing zu verarbeiten aktiviert. Sie können sie deaktivieren, um Leistungsunterschiede zu vergleichen.
Führende Routenführung aktivieren
Sie können die Spanner-Clientbibliotheken verwenden, um die Leader-Erkennung zu aktivieren manuell umzustellen.
C++
Verwenden Sie den RouteToLeaderOption
.
Struktur zur Konfiguration Ihrer Clientanwendung mit Leader-sensitivem Routing
aktiviert:
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#
EnableLeaderRouting
verwenden
So konfigurieren Sie Ihre Clientanwendung mit aktiviertem Leader-Aware Routing:
// Create a client with leader-aware routing enabled.
SpannerConnectionStringBuilder builder = new
SpannerConnectionStringBuilder();
Builder.EnableLeaderRouting = true;
Go
ClientConfig
verwenden
So konfigurieren Sie Ihre Clientanwendung mit aktiviertem Leader-Aware Routing:
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
SpannerOptions.Builder
verwenden
So konfigurieren Sie Ihre Clientanwendung mit aktiviertem Leader-Aware Routing:
SpannerOptions options = SpannerOptions.newBuilder().enableLeaderAwareRouting.build();
Spanner spanner = options.getService();
String instance = "my-instance";
String database = "my-database";
Node.js
SpannerOptions
verwenden
So konfigurieren Sie Ihre Clientanwendung mit aktiviertem Leader-Aware Routing:
// Instantiates a client with routeToLeaderEnabled enabled
const spanner = new Spanner({
projectId: projectId,
routeToLeaderEnabled: true;
});
PHP
routeToLeader
verwenden
So konfigurieren Sie Ihre Clientanwendung mit aktiviertem Leader-Aware Routing:
// Instantiates a client with leader-aware routing enabled
use Google\Cloud\Spanner\SpannerClient;
$routeToLeader = true;
$spanner = new SpannerClient($routeToLeader);
Python
route_to_leader_enabled
verwenden
So konfigurieren Sie Ihre Clientanwendung mit aktiviertem Leader-Aware Routing:
spanner_client = spanner.Client(
route_to_leader_enabled=true
)
instance = spanner_client.instance(instance_id)
database = instance.database(database_id)
Ruby
self.new
verwenden
So konfigurieren Sie Ihre Clientanwendung mit aktiviertem Leader-Aware Routing:
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
Routing auf Führungsebene deaktivieren
Mit den Spanner-Clientbibliotheken können Sie die Leader-Erkennung deaktivieren Routenplanung.
C++
Verwenden Sie den RouteToLeaderOption
.
Struktur zur Konfiguration Ihrer Clientanwendung mit Leader-sensitivem Routing
Deaktiviert:
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#
EnableLeaderRouting
verwenden
So konfigurieren Sie Ihre Clientanwendung mit deaktiviertem Leader-sensitivem Routing:
// Create a client with leader-aware routing disabled.
SpannerConnectionStringBuilder builder = new
SpannerConnectionStringBuilder();
Builder.EnableLeaderRouting = false;
Go
ClientConfig
verwenden
So konfigurieren Sie Ihre Clientanwendung mit deaktiviertem Leader-sensitivem Routing:
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
SpannerOptions.Builder
verwenden
Zum Erstellen einer Verbindung zu einer Spanner-Datenbank mit Leader
Aware-Routing deaktiviert:
SpannerOptions options = SpannerOptions.newBuilder().disableLeaderAwareRouting.build();
Spanner spanner = options.getService();
String instance = "my-instance";
String database = "my-database";
Node.js
SpannerOptions
verwenden
So konfigurieren Sie Ihre Clientanwendung mit deaktiviertem Leader-sensitivem Routing:
// Instantiates a client with routeToLeaderEnabled disabled
const spanner = new Spanner({
projectId: projectId,
routeToLeaderEnabled: false;
});
PHP
routeToLeader
verwenden
So konfigurieren Sie Ihre Clientanwendung mit deaktiviertem Leader-sensitivem Routing:
// Instantiates a client with leader-aware routing disabled
use Google\Cloud\Spanner\SpannerClient;
$routeToLeader = false;
$spanner = new SpannerClient($routeToLeader);
Python
Verwenden Sie route_to_leader_enabled
, um Ihre Clientanwendung mit deaktiviertem führerbasiertem Routing zu konfigurieren:
spanner_client = spanner.Client(
route_to_leader_enabled=false
)
instance = spanner_client.instance(instance_id)
database = instance.database(database_id)
Ruby
self.new
verwenden
So konfigurieren Sie Ihre Clientanwendung mit deaktiviertem Leader-sensitivem Routing:
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
Nächste Schritte
- Weitere Informationen zu Regional, biregional und multiregional Konfigurationen
- Replikation
- Weitere Informationen zum Ändern der führenden Region einer Datenbank