Auf dieser Seite wird das erweiterte Konzept von Sitzungen in Spanner beschrieben, einschließlich Best Practices für Sitzungen beim Erstellen einer Clientbibliothek, mithilfe der REST- oder RPC APIs oder der Google-Clientbibliotheken.
Übersicht über Sitzungen
Eine Sitzung stellt einen Kommunikationskanal mit dem Spanner-Datenbankdienst dar. In einer Sitzung werden Transaktionen ausgeführt, die Daten in einer Spanner-Datenbank lesen, schreiben oder ändern. Jede Sitzung gilt für eine einzige Datenbank.
Sitzungen können jeweils eine oder mehrere Transaktionen ausführen. Wenn mehrere Transaktionen ausgeführt werden, wird die Sitzung als gemultiplexte Sitzung bezeichnet.
Eigenständige Lese-, Schreib- und Abfragevorgänge verwenden intern eine Transaktion.
Leistungsvorteile eines Sitzungspools
Das Erstellen einer Sitzung ist teuer. Um zu vermeiden, dass für jeden Datenbankvorgang Leistungskosten anfallen, sollten Clients einen Sitzungspool führen. Dabei handelt es sich um einen Pool verfügbarer Sitzungen, die sofort verwendet werden können. Der Pool sollte vorhandene Sitzungen speichern und auf Anfrage den entsprechenden Sitzungstyp zurückgeben sowie die Bereinigung nicht verwendeter Sitzungen vornehmen. Ein Beispiel für die Implementierung eines Sitzungspools finden Sie im Quellcode für eine der Spanner-Clientbibliotheken, z. B. die Go-Clientbibliothek oder die Java-Clientbibliothek.
Sitzungen sind langlebig angelegt. Nachdem eine Sitzung für eine Datenbankoperation verwendet wurde, sollte der Client die Sitzung zur Wiederverwendung an den Pool zurückgeben.
Übersicht über gRPC-Channels
gRPC-Channels werden vom Spanner-Client für die Kommunikation verwendet. Ein gRPC-Kanal entspricht in etwa einer TCP-Verbindung. Ein gRPC-Channel kann bis zu 100 gleichzeitige Anfragen verarbeiten. Das bedeutet, dass eine Anwendung mindestens so viele gRPC-Kanäle benötigt wie die Anzahl der gleichzeitigen Anfragen, die die Anwendung ausführt, geteilt durch 100.
Der Spanner-Client erstellt beim Erstellen einen Pool von gRPC-Kanälen.
Best Practices für die Verwendung von Google-Clientbibliotheken
Im Folgenden werden Best Practices für die Verwendung der Google-Clientbibliotheken für Spanner beschrieben.
Anzahl der Sitzungen und gRPC-Channels in den Pools konfigurieren
Die Clientbibliotheken haben eine Standardanzahl von Sitzungen im Sitzungspool und eine Standardanzahl von gRPC-Kanälen im Kanalpool. Beide Standardeinstellungen sind für die meisten Fälle angemessen. Nachfolgend finden Sie die Standardwerte für die Mindest- und Höchstanzahl von Sitzungen sowie die Standardanzahl von gRPC-Channels für jede Programmiersprache.
C++
MinSessions: 100
MaxSessions: 400
NumChannels: 4
C#
MinSessions: 100
MaxSessions: 400
NumChannels: 4
Go
MinSessions: 100
MaxSessions: 400
NumChannels: 4
Java
MinSessions: 100
MaxSessions: 400
NumChannels: 4
Node.js
Der Node.js-Client unterstützt keine mehreren gRPC-Channels. Daher empfiehlt es sich, mehrere Clients zu erstellen, anstatt die Größe des Sitzungspools für einen einzelnen Client auf mehr als 100 Sitzungen zu erhöhen.
MinSessions: 25
MaxSessions: 100
PHP
Der PHP-Client unterstützt keine konfigurierbare Anzahl von gRPC-Channels.
MinSessions: 1
MaxSessions: 500
Python
Python unterstützt vier verschiedene Sitzungspooltypen, die Sie zum Verwalten von Sitzungen verwenden können.
Ruby
Der Ruby-Client unterstützt keine mehreren gRPC-Channels. Daher empfiehlt es sich, mehrere Clients zu erstellen, anstatt die Größe des Sitzungspools für einen einzelnen Client auf mehr als 100 Sitzungen zu erhöhen.
MinSessions: 10
MaxSessions: 100
Die Anzahl der Sitzungen, die von Ihrer Anwendung verwendet werden, entspricht der Anzahl der gleichzeitigen Transaktionen, die von Ihrer Anwendung ausgeführt werden. Sie sollten die Standardeinstellungen für den Sitzungspool nur ändern, wenn Sie erwarten, dass eine einzelne Anwendungsinstanz mehr gleichzeitige Transaktionen ausführt, als der Standardsitzungspool verarbeiten kann.
Für Anwendungen mit hoher Parallelität wird Folgendes empfohlen:
- Legen Sie
MinSessions
auf die erwartete Anzahl gleichzeitiger Transaktionen fest, die ein einzelner Client ausführt. - Setzen Sie
MaxSessions
auf die maximale Anzahl gleichzeitiger Transaktionen, die ein einzelner Client ausführen kann. - Legen Sie
MinSessions=MaxSessions
fest, wenn sich die erwartete Parallelität während der Lebensdauer der Anwendung nicht wesentlich ändert. Dadurch wird verhindert, dass der Sitzungspool skaliert wird. Das Hoch- oder Herunterskalieren des Sitzungspools verbraucht ebenfalls Ressourcen. - Setzen Sie
NumChannels
aufMaxSessions / 100
. Ein gRPC-Channel kann bis zu 100 Anfragen gleichzeitig verarbeiten. Erhöhen Sie diesen Wert, wenn Sie eine hohe Tail-Latenz (p95-/p99-Latenz) beobachten, da dies ein Hinweis auf eine Überlastung des gRPC-Channels sein könnte.
Wenn Sie die Anzahl der aktiven Sitzungen erhöhen, werden zusätzliche Ressourcen im Spanner-Datenbankdienst und in der Clientbibliothek verwendet. Wenn Sie die Anzahl der Sitzungen über den tatsächlichen Bedarf der Anwendung hinaus erhöhen, kann dies die Leistung Ihres Systems beeinträchtigen.
Anzahl der Sitzungen erhöhen, anstatt die Anzahl der Mandanten zu erhöhen
Die Sitzungspoolgröße für eine Anwendung bestimmt, wie viele gleichzeitige Transaktionen eine einzelne Anwendungsinstanz ausführen kann. Es wird nicht empfohlen, die Sitzungspoolgröße über die maximale Nebenläufigkeit hinaus zu erhöhen, die eine einzelne Anwendungsinstanz verarbeiten kann. Wenn die Anwendung einen Burst von Anfragen empfängt, der die Anzahl der Sitzungen im Pool überschreitet, werden die Anfragen in die Warteschlange gestellt, bis eine Sitzung verfügbar wird.
Die von der Clientbibliothek verbrauchten Ressourcen sind:
- Für jeden gRPC-Kanal wird eine TCP-Verbindung verwendet.
- Für jeden gRPC-Aufruf ist ein Thread erforderlich. Die maximale Anzahl der Threads, die von der Clientbibliothek verwendet werden, entspricht der maximalen Anzahl gleichzeitiger Abfragen, die von der Anwendung ausgeführt werden. Diese Threads kommen zu allen Threads hinzu, die die Anwendung für ihre eigene Geschäftslogik verwendet.
Es wird nicht empfohlen, die Größe des Sitzungspools über die maximale Anzahl von Threads hinaus zu erhöhen, die eine einzelne Anwendungsinstanz verarbeiten kann. Erhöhen Sie stattdessen die Anzahl der Anwendungsinstanzen.
Anteil der Schreibsitzungen verwalten
Bei einigen Clientbibliotheken reserviert Spanner einen Teil der Sitzungen für nicht schreibgeschützte Transaktionen. Dies wird als Anteil der Schreibsitzungen bezeichnet. Wenn Ihre Anwendung alle Lesesitzungen verbraucht hat, verwendet Spanner die nicht schreibgeschützten Sitzungen auch für schreibgeschützte Transaktionen. Für Lese-/Schreibvorgänge ist spanner.databases.beginOrRollbackReadWriteTransaction
erforderlich. Wenn der Nutzer die IAM-Rolle spanner.databaseReader
hat, schlägt der Aufruf fehl und Spanner gibt die folgende Fehlermeldung zurück:
generic::permission_denied: Resource %resource% is missing IAM permission:
spanner.databases.beginOrRollbackReadWriteTransaction
Bei Clientbibliotheken, die einen Anteil an Schreibsitzungen haben, können Sie diesen festlegen.
C++
Alle C ++-Sitzungen sind identisch. Es gibt keine schreibgeschützten bzw. nicht schreibgeschützten Sitzungen.
C#
Der Standardanteil der Schreibsitzungen bei C# ist 0,2. Sie können ihn im Feld „WriteSessionsFraction“ von SessionPoolOptions
ändern.
Go
Alle Go-Sitzungen sind gleich. Es gibt weder schreibgeschützte noch nicht schreibgeschützte Sitzungen.
Java
Alle Java-Sitzungen sind gleich. Es gibt keine schreibgeschützten bzw. nicht schreibgeschützten Sitzungen.
Node.js
Alle Node.js-Sitzungen sind gleich. Es gibt keine schreibgeschützten bzw. nicht schreibgeschützten Sitzungen.
PHP
Alle PHP-Sitzungen sind gleich. Es gibt keine schreibgeschützten bzw. nicht schreibgeschützten Sitzungen.
Python
Python unterstützt vier verschiedene Sitzungspooltypen, die Sie zum Verwalten von schreibgeschützten und nicht schreibgeschützten Sitzungen verwenden können.
Ruby
Der Standardanteil der Schreibsitzungen bei Ruby ist 0,3. Sie können ihn mit der client initialize-Methode ändern.
Best Practices beim Erstellen einer Clientbibliothek oder bei Verwendung von REST/RPC
Im Folgenden werden Best Practices für die Implementierung von Sitzungen in einer Clientbibliothek für Spanner und für die Verwendung von Sitzungen mit der REST API oder der RPC API beschrieben.
Diese Best Practices gelten nur, wenn Sie eine Clientbibliothek entwickeln oder wenn Sie REST/RPC-APIs verwenden. Wenn Sie eine der Google-Clientbibliotheken für Spanner verwenden, lesen Sie den Abschnitt Best Practices für die Verwendung von Google-Clientbibliotheken.
Sitzungspool erstellen und Größe festlegen
Um eine optimale Größe des Sitzungspools für einen Clientprozess festzulegen, geben Sie als untere Grenze die Anzahl der erwarteten gleichzeitigen Transaktionen an und als obere Grenze eine anfängliche Testanzahl (z. B. 100). Wenn die obere Grenze nicht ausreicht, setzen Sie sie herauf. Wenn Sie die Anzahl der aktiven Sitzungen erhöhen, werden zusätzliche Ressourcen im Spanner-Datenbankdienst verwendet. Wenn Sie also nicht verwendete Sitzungen bereinigen, kann dies die Leistung beeinträchtigen. Für Nutzer, die mit der RPC API arbeiten, empfehlen wir, nicht mehr als 100 Sitzungen pro gRPC-Kanal zu haben.
Gelöschte Sitzungen
Es gibt drei Möglichkeiten, eine Sitzung zu löschen:
- Ein Client kann eine Sitzung löschen.
- Der Spanner-Datenbankdienst kann eine Sitzung löschen, wenn die Sitzung länger als eine Stunde inaktiv ist.
- Der Spanner-Datenbankdienst kann eine Sitzung löschen, wenn die Sitzung mehr als 28 Tage alt ist.
Der Versuch, eine gelöschte Sitzung zu verwenden, führt zum Fehler NOT_FOUND
. Wenn Sie auf diesen Fehler stoßen, erstellen Sie eine neue Sitzung und verwenden Sie diese. Fügen Sie die neue Sitzung dem Pool hinzu und entfernen Sie die gelöschte Sitzung aus dem Pool.
Inaktive Sitzung offen halten
Der Spanner-Datenbankdienst behält sich das Recht vor, eine nicht verwendete Sitzung zu löschen. Wenn Sie eine inaktive Sitzung unbedingt offen halten müssen, wenn z. B. eine signifikante Erhöhung der Datenbanknutzung in naher Zukunft erwartet wird, können Sie verhindern, dass die Sitzung gelöscht wird. Führen Sie einen kostengünstigen Vorgang wie das Ausführen der SQL-Abfrage SELECT 1
durch, um die Sitzung aktiv zu halten. Wenn Sie eine inaktive Sitzung haben, die nicht in naher Zukunft verwendet werden soll, erlauben Sie, dass sie von Spanner gelöscht wird. Erstellen Sie eine neue Sitzung, wenn das nächste Mal eine Sitzung benötigt wird.
Ein Szenario, in dem Sitzungen offen gehalten werden, ist der Umgang mit regulärer Spitzennachfrage der Datenbank. Wenn eine starke Datenbanknutzung täglich von 9:00 Uhr bis 18:00 Uhr stattfindet, sollten Sie während dieser Zeit einige inaktive Sitzungen offen halten, da diese wahrscheinlich zu Spitzenzeiten erforderlich sind. Nach 18:00 Uhr kann Spanner inaktive Sitzungen wieder löschen. Erstellen Sie jeden Tag vor 9:00 Uhr einige neue Sitzungen, damit sie für die erwartete Nachfrage bereitstehen.
Ein anderes Szenario wäre, dass Sie eine Anwendung haben, die Spanner verwendet, aber den Verbindungsaufwand dabei vermeiden muss. Sie können eine Gruppe von Sitzungen offen halten, um den Verbindungsaufwand zu vermeiden.
Sitzungsdetails vom Clientbibliotheksbenutzer ausblenden
Wenn Sie eine Clientbibliothek erstellen, sollten Sie dem Clientbibliotheksbenutzer keine Sitzungen anzeigen. Stellen Sie die Möglichkeit für den Client bereit, Datenbankaufrufe ohne den Aufwand der Erstellung und Verwaltung von Sitzungen durchzuführen. Ein Beispiel für eine Clientbibliothek, in der die Sitzungsdetails vor dem Clientbibliothekbenutzer ausgeblendet werden, finden Sie in der Spanner-Clientbibliothek für Java.
Fehler bei Schreibtransaktionen bearbeiten, die nicht idempotent sind
Schreibtransaktionen ohne Wiederholungsschutz können Mutationen mehr als einmal anwenden.
Wenn eine Mutation nicht idempotent ist, kann eine Mutation, die mehrmals angewendet wird, zu einem Fehler führen. Beispiel: Eine Einfügung (Insert) kann den Fehler ALREADY_EXISTS
verursachen, obwohl die Zeile vor dem Schreibversuch nicht vorhanden war. Dies kann passieren, wenn der Back-End-Server die Mutation festgeschrieben hat, den Erfolg jedoch nicht dem Client mitteilen konnte. In diesem Fall könnte die Mutation wiederholt werden, was aber zu dem Fehler ALREADY_EXISTS
führen würde.
Im Folgenden sind einige Möglichkeiten aufgelistet, wie Sie mit diesem Szenario bei der Bereitstellung Ihrer eigenen Clientbibliothek oder bei der Verwendung der REST API verfahren können:
- Strukturieren Sie Ihre Schreibvorgänge so, dass sie idempotent sind.
- Verwenden Sie Schreibvorgänge mit Wiederholungsschutz.
- Implementieren Sie eine Methode mit der Logik "upsert": einfügen, wenn neu, oder aktualisieren, wenn bereits vorhanden.
- Bearbeiten Sie den Fehler für den Client.
Für stabile Verbindungen sorgen
Für eine optimale Leistung sollte die Verbindung, die Sie zum Hosten einer Sitzung verwenden, stabil sein. Wenn sich die Hostingverbindung für eine Sitzung ändert, bricht Spanner möglicherweise die aktive Transaktion in der Sitzung ab. Dies führt während der Aktualisierung der Sitzungsmetadaten zu einer geringfügigen Mehrbelastung Ihrer Datenbank. Wenn sich einige Verbindungen gelegentlich ändern, ist das kein Problem, aber Sie sollten Situationen vermeiden, in denen sich eine große Anzahl von Verbindungen gleichzeitig ändert. Falls Sie einen Proxy zwischen dem Client und Spanner einsetzen, sollten Sie bei jeder Sitzung für eine stabile Verbindung sorgen.
Aktive Sitzungen überwachen
Mit dem Befehl ListSessions
können Sie aktive Sitzungen in Ihrer Datenbank über die Befehlszeile, mit der REST API oder mit der RPC API überwachen. ListSessions
zeigt die aktiven Sitzungen für eine bestimmte Datenbank an. Dies ist sinnvoll, wenn Sie die Ursache für ein Sitzungsleck finden möchten. Ein Sitzungsleck ist ein Vorfall, bei dem Sitzungen erstellt, aber nicht zur Wiederverwendung an einen Sitzungspool zurückgegeben werden.
Mit ListSessions
können Sie Metadaten zu Ihren aktiven Sitzungen abrufen, z. B. wann eine Sitzung erstellt und wann eine Sitzung zuletzt verwendet wurde. Die Analyse dieser Daten wird Ihnen bei der Fehlersuche die richtige Richtung weisen. Wenn die approximate_last_use_time
für die meisten aktiven Sitzungen schon länger zurückliegt, deutet dies eventuell darauf hin, dass Sitzungen von Ihrer Anwendung nicht ordnungsgemäß wiederverwendet werden. Weitere Informationen zum Feld approximate_last_use_time
finden Sie in der RPC API-Referenz.
Weitere Informationen zur Verwendung von ListSessions
finden Sie in der REST API-Referenz, der RPC API-Referenz oder der Referenz zum gcloud-Befehlszeilentool.
Automatische Bereinigung von Sitzungslecks
Wenn Sie alle Sitzungen in Ihrem Sitzungspool verwenden, wartet jede neue Transaktion, bis eine Sitzung an den Pool zurückgegeben wird. Wenn Sitzungen erstellt, aber nicht zur Wiederverwendung an den Sitzungspool zurückgegeben werden, spricht man von einem Sitzungsleck. Bei einem Sitzungsleck bleiben Transaktionen, die auf eine offene Sitzung warten, auf unbestimmte Zeit hängen und blockieren die Anwendung. Sitzungslecks werden häufig durch problematische Transaktionen verursacht, die extrem lange ausgeführt werden und nicht committet werden.
Sie können Ihren Sitzungspool so einrichten, dass diese inaktiven Transaktionen automatisch aufgelöst werden. Wenn Sie Ihre Clientbibliothek so konfigurieren, dass inaktive Übergänge automatisch behoben werden, werden problematische Transaktionen erkannt, die möglicherweise zu einem Sitzungsleck führen. Sie werden aus dem Sitzungspool entfernt und durch eine neue Sitzung ersetzt.
Die Protokollierung kann auch dabei helfen, diese problematischen Transaktionen zu identifizieren. Wenn das Logging aktiviert ist, werden Warnungsprotokolle standardmäßig freigegeben, wenn mehr als 95% Ihres Sitzungspools verwendet werden. Wenn die Sitzungsnutzung mehr als 95 % beträgt, müssen Sie entweder die maximal zulässige Anzahl von Sitzungen in Ihrem Sitzungspool erhöhen oder es liegt möglicherweise ein Sitzungsleck vor. Warnungsprotokolle enthalten Stacktraces von Transaktionen, die länger als erwartet ausgeführt werden. Sie können helfen, die Ursache für eine hohe Auslastung des Sitzungspools zu ermitteln. Warnungslogs werden je nach Konfiguration des Log-Exporters übertragen.
Clientbibliothek aktivieren, um inaktive Transaktionen automatisch zu beheben
Sie können entweder aktivieren, dass die Clientbibliothek Warnungsprotokolle sendet und inaktive Transaktionen automatisch behebt, oder dass die Clientbibliothek nur Warnungsprotokolle empfängt.
Java
Wenn Sie Warnungsprotokolle erhalten und inaktive Transaktionen entfernen möchten, verwenden Sie setWarnAndCloseIfInactiveTransactions
.
final SessionPoolOptions sessionPoolOptions = SessionPoolOptions.newBuilder().setWarnAndCloseIfInactiveTransactions().build()
final Spanner spanner =
SpannerOptions.newBuilder()
.setSessionPoolOption(sessionPoolOptions)
.build()
.getService();
final DatabaseClient client = spanner.getDatabaseClient(databaseId);
Wenn Sie nur Warnungsprotokolle erhalten möchten, verwenden Sie setWarnIfInactiveTransactions
.
final SessionPoolOptions sessionPoolOptions = SessionPoolOptions.newBuilder().setWarnIfInactiveTransactions().build()
final Spanner spanner =
SpannerOptions.newBuilder()
.setSessionPoolOption(sessionPoolOptions)
.build()
.getService();
final DatabaseClient client = spanner.getDatabaseClient(databaseId);
Go
Wenn Sie Warnungsprotokolle erhalten und inaktive Transaktionen entfernen möchten, verwenden Sie SessionPoolConfig
mit InactiveTransactionRemovalOptions
.
client, err := spanner.NewClientWithConfig(
ctx, database, spanner.ClientConfig{SessionPoolConfig: spanner.SessionPoolConfig{
InactiveTransactionRemovalOptions: spanner.InactiveTransactionRemovalOptions{
ActionOnInactiveTransaction: spanner.WarnAndClose,
}
}},
)
if err != nil {
return err
}
defer client.Close()
Wenn Sie nur Warnungsprotokolle erhalten möchten, verwenden Sie customLogger
.
customLogger := log.New(os.Stdout, "spanner-client: ", log.Lshortfile)
// Create a logger instance using the golang log package
cfg := spanner.ClientConfig{
Logger: customLogger,
}
client, err := spanner.NewClientWithConfig(ctx, db, cfg)
Gemultiplexte Sitzungen
Mit gemultiplexten Sitzungen können Sie eine große Anzahl gleichzeitiger Anfragen in einer einzigen Sitzung erstellen. Eine gemultiplexte Sitzung ist eine Kennung, die Sie für mehrere gRPC-Kanäle verwenden. Es entstehen keine zusätzlichen Engpässe. Multiplex-Sitzungen bieten folgende Vorteile:
- Geringerer Backend-Ressourcenverbrauch aufgrund eines einfacheren Protokolls für die Sitzungsverwaltung. So werden beispielsweise Sitzungswartungsaktivitäten vermieden, die mit der Wartung des Sitzungsinhabers und der Garbage Collection verbunden sind.
- Langlebige Sitzung, für die im Leerlauf keine Keep-Alive-Anfragen erforderlich sind.
Multiplexing-Sitzungen werden in den folgenden Fällen unterstützt:
- Die Clientbibliotheken für Java und Go.
Spanner-Ökosystemtools, die von den Java- und Go-Clientbibliotheken abhängen, z. B. PGAdapter, JDBC, Hibernate, database/sql-Treiber und GORM.
Spanner-Ökosystemtools, die von den Java- und Go-Clientbibliotheken abhängen, z. B. PGAdapter, JDBC, Hibernate, Datenbank- oder SQL-Treiber und GORM. Mit OpenTelemetry-Messwerten können Sie sehen, wie der Traffic zwischen dem vorhandenen Sitzungspool und der gemultiplexten Sitzung aufgeteilt wird. OpenTelemetry hat einen Messwertfilter,
is_multiplexed
, der Multiplex-Sitzungen anzeigt, wenn er auftrue
festgelegt ist.
Multiplex-Sitzungen werden für alle Arten von Transaktionen unterstützt.
Clientbibliotheken rotieren gemultiplexte Sitzungen alle 7 Tage, um zu verhindern, dass Transaktionen über abgelaufene Sitzungen gesendet werden.
Multiplex-Sitzungen sind standardmäßig deaktiviert. Sie müssen Umgebungsvariablen verwenden, um Multiplexing-Sitzungen zu aktivieren, bevor Sie sie in Ihren Clientanwendungen verwenden können. Informationen zum Aktivieren von gemultiplexten Sitzungen mit Java oder Go finden Sie unter Gemultiplexte Sitzungen aktivieren.
Hinweise
Wenn Sie versuchen, entweder einen leeren Lese- oder Schreibtransaktionsbody oder eine Transaktion zu committen, bei der jede Abfrage oder DML-Anweisung fehlgeschlagen ist, gibt es einige Szenarien, die bei gemultiplexten Sitzungen zu berücksichtigen sind. Bei gemultiplexten Sitzungen müssen Sie in jede Commit-Anfrage ein vom Server generiertes Pre-Commit-Token einfügen. Bei Transaktionen, die Abfragen oder DML enthalten, muss es mindestens eine vorherige erfolgreiche Abfrage- oder DML-Transaktion geben, damit der Server ein gültiges Token an die Clientbibliothek zurücksenden kann. Wenn es keine erfolgreichen Abfragen oder DML-Transaktionen gab, fügt die Clientbibliothek vor einem Commit implizit SELECT 1
hinzu.
Bei einer Lese- oder Schreibtransaktion für eine gemultiplexte Sitzung, die nur Mutationen enthält, kann der Client einen INVALID_ARGUMENT
-Fehler anstelle eines NOT_FOUND
-Fehlers zurückgeben, wenn eine der Mutationen für eine Tabelle oder Spalte gilt, die NICHT im Schema vorhanden ist.
Multiplex-Sitzungen aktivieren
Wenn Sie Multiplexing-Sitzungen in Ihren Clientanwendungen verwenden möchten, müssen Sie zuerst eine Umgebungsvariable festlegen, um sie zu aktivieren.
Zum Aktivieren von Multiplex-Sitzungen setzen Sie die Umgebungsvariable GOOGLE_CLOUD_SPANNER_MULTIPLEXED_SESSIONS
auf TRUE
. Dieses Flag aktiviert auch die Unterstützung von Multiplex-Sitzungen für ReadOnly
-Transaktionen.
export GOOGLE_CLOUD_SPANNER_MULTIPLEXED_SESSIONS=TRUE
Wenn Sie die Unterstützung für partitionierte Vorgänge für gemultiplexte Sitzungen aktivieren möchten, legen Sie die Umgebungsvariable GOOGLE_CLOUD_SPANNER_MULTIPLEXED_SESSIONS_PARTITIONED_OPS
auf TRUE
fest.
export GOOGLE_CLOUD_SPANNER_MULTIPLEXED_SESSIONS_PARTITIONED_OPS=TRUE
Wenn Sie die Unterstützung von Lese-/Schreibtransaktionen für gemultiplexte Sitzungen aktivieren möchten, setzen Sie die Umgebungsvariable GOOGLE_CLOUD_SPANNER_MULTIPLEXED_SESSIONS_FOR_RW
auf TRUE
.
export GOOGLE_CLOUD_SPANNER_MULTIPLEXED_SESSIONS_FOR_RW=True
Sie müssen GOOGLE_CLOUD_SPANNER_MULTIPLEXED_SESSIONS
auf TRUE
festlegen, damit eine Transaktion in einer gemultiplexten Sitzung unterstützt werden kann.
Traffic für reguläre und gemultiplexte Sitzungen ansehen
Opentelemetry hat den Filter is_multiplexed
, um den Traffic für gemultiplexte Sitzungen anzuzeigen. Wenn Sie diesen Filter auf „true to view multiplexed sessions
and
false“ festlegen, werden reguläre Sitzungen angezeigt.
- Richten Sie Opentelemetry für Spanner ein, indem Sie die Schritte im Abschnitt Vorbereitung unter „Spanner Opentelemetry“ ausführen.
Rufen Sie den Metrics Explorer auf.
Filtern Sie im Drop-down-Menü Messwert nach
generic
.Klicken Sie auf Generic Task (Allgemeine Aufgabe) und rufen Sie Spanner > Spanner/num_acquired_sessions auf.
Wählen Sie im Feld Filter eine der folgenden Optionen aus:
a.
is_multiplexed = false
, um reguläre Sitzungen anzusehen. b.is_multiplexed = true
, um gemultiplexte Sitzungen aufzurufen.Das folgende Bild zeigt die Option Filter mit ausgewählten gemultiplexten Sitzungen.
Weitere Informationen zur Verwendung von OpenTelemetry mit Spanner finden Sie unter Leveraging OpenTelemetry to democratize Spanner Observability und Examine latency in a Spanner component with OpenTelemetry.