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.
Eine Sitzung bietet einen Kontext für Datenbankvorgänge mit dem Spanner-Datenbankdienst. 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.
Sitzungsleistung verwalten
Sitzungen sind der Kontext für einen Datenbankvorgang. Wie Sie sie verwalten, wirkt sich direkt auf die Latenz und die Ressourcennutzung Ihrer Anwendung aus. Sie haben drei Möglichkeiten, die Sitzungsleistung zu verwalten:
Sitzungspool verwenden
Das Erstellen einer Sitzung führt zu einer zusätzlichen Latenz, da für jede neue Sitzung ein Umlauf zum Spanner-Datenbankdienst erforderlich ist. Um diese Latenz zu reduzieren, können Sie einen Sitzungspool verwenden. Das ist eine Sammlung verfügbarer Sitzungen, die sofort verwendet werden können. Anstatt für jeden Vorgang eine Sitzung zu erstellen, gibt der Pool eine vorhandene Sitzung zurück und fordert sie danach zur Wiederverwendung zurück. Dadurch wird die Latenz bei der Sitzungserstellung auf viele Vorgänge verteilt, anstatt sie vollständig zu eliminieren. Der Pool speichert vorhandene Sitzungen, gibt auf Anfrage den entsprechenden Sitzungstyp zurück und bereinigt nicht verwendete Sitzungen.
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.
Multiplexing-Sitzungen verwenden
Mit gemultiplexten Sitzungen können Sie mehrere gleichzeitige Anfragen in einer einzigen Sitzung stellen. Dadurch werden der Backend-Aufwand und der Ressourcenverbrauch reduziert. Weitere Informationen finden Sie unter Gemultiplexte Sitzungen.
gRPC-Channel-Konfiguration optimieren
Reduzieren Sie die hohe Extremwertlatenz (P95/P99), die durch eine Überlastung des gRPC-Kanals bei hohem Traffic verursacht wird, indem Sie den gRPC-Kanalpool optimieren. In unterstützten Clientbibliotheken wird der Channelpool durch dynamisches Channel-Pooling automatisch an die Last angepasst. So lässt sich die durch Überlastung bedingte Tail-Latenz reduzieren und eine Unter- oder Überbereitstellung von Channels vermeiden.
Übersicht über gRPC-Channels
gRPC-Channels werden vom Spanner-Client für die Kommunikation verwendet. Ein gRPC-Channel 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-Channels 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
Wie Sie Sitzungen und gRPC-Channels verwalten, hängt von der Clientbibliothek ab. Bei Clientbibliotheken, die Multiplex-Sitzungen unterstützen, z. B. die Go- und Java-Clientbibliotheken, müssen Sie keinen Sitzungspool konfigurieren. Der gRPC-Kanalpool kann über dynamisches Channel-Pooling verwaltet werden. Die anderen Clientbibliotheken verwenden einen Sitzungspool mit einer standardmäßigen Mindest- und Höchstanzahl von Sitzungen sowie einer standardmäßigen Anzahl von gRPC-Channels. Die Standardeinstellungen sind für die meisten Fälle ausreichend. In den folgenden Abschnitten werden die Standardeinstellungen und Konfigurationsoptionen für die einzelnen Programmiersprachen beschrieben.
C++
MinSessions: 100
MaxSessions: 400
NumChannels: 4
C#
MinSessions: 100
MaxSessions: 400
NumChannels: 4
Go
Multiplexing-Sitzungen sind standardmäßig aktiviert und erfordern keine Konfiguration.
Die dynamische Channel-Zusammenfassung ist eine optionale Funktion. Wenn Sie die Funktion nicht aktivieren, verwendet der Client vier gRPC-Channels. Wenn Sie eine andere feste Anzahl von gRPC-Channels verwenden möchten, verwenden Sie die Option option.WithGRPCConnectionPool, wenn Sie den Client erstellen:
// Use 16 gRPC channels instead of the default of four.
client, err := spanner.NewClient(ctx,
"projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID",
option.WithGRPCConnectionPool(16),
)
Für dieses Beispiel ist das Paket google.golang.org/api/option erforderlich.
Wenn Sie das dynamische Channel-Pooling aktivieren möchten, setzen Sie die Option DCPEnabled in DynamicChannelPoolConfig auf true:
client, err := spanner.NewClientWithConfig(ctx,
"projects/PROJECT_ID/instances/INSTANCE_ID/databases/DATABASE_ID",
spanner.ClientConfig{
DynamicChannelPoolConfig: spanner.DynamicChannelPoolConfig{
DCPEnabled: true,
},
})
Wenn Sie das dynamische Channel-Pooling aktivieren, ohne benutzerdefinierte Optionen festzulegen, wendet die Go-Clientbibliothek die folgenden Standardeinstellungen an:
- Anfängliche Poolgröße: 4 Channels
- Mindestpoolgröße: 2 Channels
- Maximale Poolgröße: 10 Kanäle
- Skalierungsschwelle: 25 gleichzeitige RPCs pro Channel
- Skalierungsuntergrenze: 15 gleichzeitige RPCs pro Channel
- Intervall für die Prüfung auf Herunterskalieren: 3 Minuten
Um den Pool anzupassen, legen Sie die Felder des DynamicChannelPoolConfig-Structs fest, z. B. DCPInitialChannels, DCPMinChannels, DCPMaxChannels, DCPMaxRPCPerChannel und DCPMinRPCPerChannel.
Java
Multiplexing-Sitzungen sind in Version 6.98.0 oder höher der Java-Clientbibliothek standardmäßig aktiviert und erfordern keine Konfiguration. Weitere Informationen finden Sie unter Gemultiplexte Sitzungen.
Das dynamische Channel-Pooling ist für die Java-Clientbibliothek standardmäßig deaktiviert und muss mit SpannerOptions aktiviert werden. Wenn das dynamische Channel-Pooling nicht aktiviert ist, verwendet die Java-Clientbibliothek 4 gRPC-Channels (8 Channels, wenn die gRPC-GCP-Erweiterung aktiviert ist). Wenn das dynamische Channel-Pooling aktiviert ist, ändert die Clientbibliothek die Größe des gRPC-Channel-Pools, um sich an sich ändernde Arbeitslasten anzupassen. So werden Leistungsprobleme durch unter- oder überbereitgestellte Channels vermieden.
Wenn Sie das dynamische Channel-Pooling aktivieren möchten, fügen Sie enableDynamicChannelPool in SpannerOptions ein:
SpannerOptions options =
SpannerOptions.newBuilder()
.setProjectId("PROJECT_ID")
.enableDynamicChannelPool()
.build();
Wenn Sie die Anzahl der Kanäle mit setNumChannels konfigurieren, deaktiviert Spanner das dynamische Channel-Pooling und verwendet eine statische Anzahl von Kanälen.
Wenn Sie das dynamische Channel-Pooling aktivieren, ohne benutzerdefinierte Optionen über setGcpChannelPoolOptions festzulegen, wendet die Java-Clientbibliothek die folgenden Standardeinstellungen an, die für typische Arbeitslasten optimiert sind:
- Anfängliche Poolgröße: 4 Channels
- Mindestpoolgröße: 2 Channels
- Maximale Poolgröße: 10 Kanäle (Obergrenze: 256 Kanäle)
- Skalierungsschwelle: 25 gleichzeitige RPCs pro Channel
- Skalierungsuntergrenze: 15 gleichzeitige RPCs pro Channel
- Intervall für das Herunterskalieren: 3 Minuten
Verwenden Sie setGcpChannelPoolOptions, um das dynamische Channel-Pooling anzupassen. Beispiel:
SpannerOptions options =
SpannerOptions.newBuilder()
.setProjectId("PROJECT_ID")
.enableDynamicChannelPool()
.setGcpChannelPoolOptions(
GcpChannelPoolOptions.newBuilder()
.setMaxSize(15)
.setMinSize(3)
.setInitSize(5)
// setDynamicScaling(minRpcPerChannel, maxRpcPerChannel,
// scaleDownInterval): scale up as soon as a channel's load
// exceeds 30 concurrent RPCs. Scale-up is event-driven, so
// the pool grows immediately as load rises. Scale-down is
// periodic: a channel is removed only after it stays under
// 10 concurrent RPCs across the check that runs every 5
// minutes.
.setDynamicScaling(10, 30, Duration.ofMinutes(5))
.build())
.build();
Berücksichtigen Sie die folgenden Kompromisse beim dynamischen Channel-Pooling:
- Skalierungsaufwand: Das Skalieren des Pools ist mit Aufwand verbunden, da gRPC-Kanäle und TCP-Verbindungen erstellt und zerstört werden müssen. Bei latenzempfindlichen Arbeitslasten mit starken Spitzen kann ein großer statischer Pool eine bessere Wahl sein, um die Skalierungslatenz zu vermeiden.
- Konfigurationsüberschreibungen: Wenn Sie die Basisanzahl der Channels festlegen, wird das dynamische Channel-Pooling deaktiviert. Weitere Informationen finden Sie unter
setNumChannels. - Ressourcennutzung: Ein statischer Channel-Pool verwendet eine feste Menge an Arbeitsspeicher und Verbindungen, während die Ressourcennutzung eines dynamischen Pools je nach Last variiert.
Node.js
Der Node.js-Client unterstützt keine mehreren gRPC-Channels. Es wird daher empfohlen, 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. Es wird daher empfohlen, 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
Verwenden Sie Multiplex-Sitzungen, wenn die Clientbibliothek für Ihre Programmiersprache sie unterstützt. Für gemultiplexte Sitzungen ist keine Konfiguration erforderlich und in einer einzelnen gemultiplexten Sitzung können beliebig viele gleichzeitige Transaktionen ausgeführt werden.
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
MinSessionsauf die erwartete Anzahl gleichzeitiger Transaktionen fest, die ein einzelner Client ausführt. - Setzen Sie
MaxSessionsauf die maximale Anzahl gleichzeitiger Transaktionen, die ein einzelner Client ausführen kann. - Legen Sie
MinSessions=MaxSessionsfest, 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
NumChannelsaufMaxSessions / 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 den 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 Cloud 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 auftreten, wenn der Back-End-Server die Mutation festgeschrieben hat, dies aber dem Client nicht 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 weist Sie bei der Fehlersuche in die richtige Richtung. 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 oft 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. Diese Transaktionen 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 Sitzungsauslastung mehr als 95 % beträgt, müssen Sie entweder die maximale Anzahl der zulässigen 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 entsprechend Ihrer Log-Exporter-Konfiguration ü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 Warnungslogs 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. Multiplexing-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 automatischen Speicherbereinigung zusammenhängen.
- Langlebige Sitzung, für die im Leerlauf keine Keep-Alive-Anfragen erforderlich sind.
Multiplex-Sitzungen werden in den folgenden Fällen unterstützt:
- Die Clientbibliotheken für C++, Go, Java, Node.js, PHP, Python und Ruby.
Tools aus dem Spanner-Ökosystem, die von den genannten Clientbibliotheken abhängen, z. B. PGAdapter, JDBC, Hibernate, database/sql-Treiber, dbAPI-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 auftruefestgelegt 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.
Multiplexing-Sitzungen sind in einigen Clientbibliotheken standardmäßig aktiviert. Für andere müssen Sie Umgebungsvariablen verwenden, um sie zu aktivieren. Weitere Informationen finden Sie unter Multiplexing-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
Multiplexing-Sitzungen sind in den folgenden Clientbibliotheken standardmäßig aktiviert:
- C++ in Version 2.41.0 und höher.
- Go in Version 1.85.0 und höher.
- Java in Version 6.98.0 und höher.
- Node.js in Version 8.3.0 und höher.
- PHP in Version 2.0.0 und höher.
- Python in Version 3.57.0 und höher.
- Ruby in Version 2.30.0 und höher.
Wenn Sie multiplexierte Sitzungen in früheren Versionen der Node.js-, Java- und Go-Clientbibliotheken 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 enthält den Filter is_multiplexed, um Traffic für gemultiplexte Sitzungen anzuzeigen. Legen Sie diesen Filter auf true fest, um gemultiplexte Sitzungen aufzurufen, oder auf false, um reguläre Sitzungen aufzurufen.
- Richten Sie OpenTelemetry für Spanner ein. Folgen Sie dazu der Anleitung im Abschnitt Vorbereitung unter „Spanner OpenTelemetry“.
Rufen Sie den Metrics Explorer auf.
Filtern Sie im Drop-down-Menü Messwert nach
generic.Klicken Sie auf Generic Task (Allgemeine Aufgabe) und gehen Sie zu Spanner > Spanner/num_acquired_sessions.
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 anzusehen.Auf dem folgenden Bild ist die Option Filter mit ausgewählten gemultiplexten Sitzungen zu sehen.
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.
Fehlerbehebung
Häufige sitzungsbezogene Fehler, die in Ihrer Anwendung auftreten können:
Session not foundRESOURCE_EXHAUSTED
Weitere Informationen finden Sie unter Sitzungsfehler.