Problembehandlung für Synapse Studio

Dieses Handbuch zur Problembehandlung enthält Anweisungen dazu, welche Informationen beim Öffnen eines Supporttickets für Netzwerkkonnektivitätsprobleme bereitgestellt werden sollen. Mit den richtigen Informationen können wir das Problem möglicherweise schneller beheben.

Die Veröffentlichung schlägt fehl, wenn die Sitzung im Leerlauf bleibt

Symptom

Wenn Ihre Browsersitzung über einen längeren Zeitraum inaktiv war, kann es vorkommen, dass Ihr Versuch der Veröffentlichung aufgrund einer Meldung über den Ablauf des Tokens fehlschlägt:

ERROR: Unauthorized Inner error code: ExpiredAuthenticationToken Message: Token Authentication failed with SecurityTokenExpiredException - MISE12034: AuthenticationTicketProvider Name:AuthenticationTicketProvider, GetVersion:1.9.2.0.;

Grundursache und Lösung

Der Umgang mit dem Ablauf von Token in Synapse Studio erfordert sorgfältige Überlegungen, insbesondere wenn Sie in einem Live-Arbeitsbereich ohne Git-Integration arbeiten. Hier erfahren Sie, wie Sie Ihre Sitzung verwalten, um zu vermeiden, dass Arbeit verloren geht:

• Mit Git-Integration:
  • Committen Sie Ihre Änderungen regelmäßig. Dadurch wird sichergestellt, dass Ihre Arbeit sicher gespeichert wird, selbst wenn Sie Ihren Browser aktualisieren müssen, um Ihre Sitzung zu erneuern.
  • Nach dem Commit können Sie Ihren Browser aktualisieren, um die Sitzung zurückzusetzen, und dann mit der Veröffentlichung Ihrer Änderungen fortfahren.
• Ohne Git-Integration:
  • Versuchen Sie, Ihre Änderungen zu veröffentlichen, bevor Sie Pausen einlegen oder längere Zeit nicht aktiv sind. Wenn Ihre Sitzung längere Zeit inaktiv war, kann es sein, dass durch den Ablauf des Tokens ein Fehler auftritt, wenn Sie nach Ihrer Rückkehr versuchen, zu veröffentlichen.
  • Wenn Sie befürchten, dass ungespeicherte Änderungen aufgrund einer erforderlichen Aktualisierung verloren gehen, sollten Sie Ihre Arbeitszeiten so strukturieren, dass häufige Speicher- und Veröffentlichungsvorgänge enthalten sind, und vermeiden, die Sitzung für längere Zeit im Leerlauf zu lassen.

Dienstkonnektivitätsproblem bei serverlosem SQL-Pool

Symptom 1

Die Option „Serverloser SQL-Pool“ ist in der Dropdownliste Verbinden mit abgeblendet dargestellt.

Symptom 2

Wenn Sie die Abfrage mit „Serverloser SQL-Pool“ ausführen, erhalten Sie die Fehlermeldung „Fehler beim Herstellen einer Verbindung zum Server“.

Schritte zur Problembehandlung

Öffnen Sie den Bereich "Diagnoseinformationen ", und wählen Sie die Schaltfläche " Diagnose herunterladen " aus. Behalten Sie die heruntergeladenen Informationen für die Fehlerberichterstellung bei. Sie können stattdessen die „Sitzungs-ID“ kopieren und beim Öffnen des Supporttickets anfügen.

Wiederholen Sie den Vorgang, den Sie in Synapse Studio ausgeführt haben, um die Problembehandlung zu beginnen.

• Wählen Sie für Symptom 1 die Schaltfläche " Aktualisieren " auf der Registerkarte "SQL-Skript " aus, und überprüfen Sie, ob "serverloser SQL-Pool" angezeigt wird.
• Versuchen Sie bei Symptom 2, die Abfrage erneut auszuführen, um zu prüfen, ob sie erfolgreich ausgeführt wird.

Wenn das Problem weiterhin besteht, drücken Sie F12 in Ihrem Browser, um Entwicklertools (DevTools) zu öffnen.

Wechseln Sie im Fenster "Entwicklertools " zum Netzwerkbereich . Wählen Sie bei Bedarf die Schaltfläche " Löschen " auf der Symbolleiste im Netzwerkbereich aus.

Stellen Sie sicher, dass Cache deaktivieren im Netzwerkbereich aktiviert ist.

Wiederholen Sie den Vorgang, den Sie in Azure Synapse Studio ausgeführt haben. Möglicherweise werden in der Netzwerkliste in den Entwicklertools neue Elemente angezeigt. Notieren Sie sich die aktuelle Systemzeit, die im Supportticket bereitgestellt werden soll.

Suchen Sie das Element, dessen URL-Spalte dem folgenden Muster entspricht:

https://[*A*]-ondemand.database.windows.net:1443/databases/[*B*]/query?api-version=2018-08-01-preview&application=ArcadiaSqlOnDemandExplorer

Wo *A* Ihr Arbeitsbereichsname ist und wo -ondemand-sqlod sein könnte und wo *B* ein Datenbankname sein sollte, wie master. Es sollten höchstens zwei Elemente mit demselben URL-Wert vorhanden sein, aber unterschiedliche Methodenwerte; OPTIONS und POST. Überprüfen Sie, ob diese beiden Elemente in der Spalte „Status“ den Wert 200 oder 20x aufweisen, wobei x eine beliebige einzelne Ziffer sein könnte.

Wenn einer von ihnen etwas anderes hat als 20x und:

• Der Status beginnt mit "(fehlgeschlagen)", entweder die Status-Spalte verbreitern oder den Mauszeiger über den Statustext bewegen, damit der vollständige Text angezeigt wird. Fügen Sie den Text und/oder den Screenshot ein, wenn Sie das Supportticket öffnen.

  

  • Wenn ERR_NAME_NOT_RESOLVED angezeigt wird und Sie Ihren Arbeitsbereich innerhalb von 10 Minuten erstellt haben, warten Sie 10 Minuten und versuchen Sie erneut zu prüfen, ob das Problem immer noch besteht.
  • Wenn ERR_INTERNET_DISCONNECTED oder ERR_NETWORK_CHANGED angezeigt wird, weist dies möglicherweise darauf hin, dass ihre PC-Netzwerkverbindung Probleme hat. Überprüfen Sie Ihre Netzwerkverbindung, und wiederholen Sie den Vorgang.
  • Wenn ERR_CONNECTION_RESET, ERR_SSL_PROTOCOL_ERROR oder andere Fehlercodes mit "SSL" angezeigt werden, kann es darauf hindeuten, dass Ihre lokale SSL-Konfiguration Probleme hat, oder Ihr Netzwerkadministrator hat den Zugriff auf den serverlosen SQL-Poolserver blockiert. Öffnen Sie ein Supportticket, und fügen Sie den Fehlercode in der Beschreibung ein.
  • Wenn ERR_NETWORK_ACCESS_DENIED angezeigt wird, müssen Sie möglicherweise mit dem Administrator überprüfen, ob die lokale Firewallrichtlinie den Zugriff auf *.database.windows.net Domäne oder Remoteport 1443 blockiert hat.
  • Versuchen Sie optional, den gleichen Vorgang direkt auf einem anderen Computer und/oder in einer Netzwerkumgebung auszuführen, um ein Problem mit der Netzwerkkonfiguration auf Ihrem PC auszuschließen.

• Der Status ist 40x, 50x oder ein anderer Wert. Wählen Sie die Elemente aus, um Details anzuzeigen. Die Details zum Element sollten auf der rechten Seite angezeigt werden. Suchen Sie den Abschnitt „Antwortheader“, und prüfen Sie dann, ob ein Element namens „access-control-allow-origin“ vorhanden ist. Wenn dies der Fall ist, überprüfen Sie, ob es einen der folgenden Werte aufweist:

  • * (einzelnes Sternchen)
  • https://web.azuresynapse.net/ (oder ein anderer Wert, mit dem der Text in der Adressleiste des Browsers beginnt)

Wenn der Antwortheader einen dieser Werte enthält, bedeutet dies, dass wir die Fehlerinformationen bereits gesammelt haben sollten. Sie können bei Bedarf ein Supportticket öffnen und optional den Screenshot der Elementdetails anfügen.

Wenn die Kopfzeile nicht angezeigt wird oder die Kopfzeile keinen dieser Werte enthält, fügen Sie beim Öffnen des Tickets einen Screenshot der Elementdetails an.

Wenn die oben genannten Schritte Ihr Problem nicht lösen, müssen Sie möglicherweise ein Supportticket öffnen. Wenn Sie Ihr Supportticket übermitteln, geben Sie die „Sitzungs-ID“ oder „Diagnoseinformationen“ an, die am Anfang dieses Leitfadens heruntergeladen wurden.

Wenn Sie das Problem melden, können Sie optional einen Screenshot ihrer Konsolenregisterkarte in den Entwicklertools erstellen und an das Supportticket anfügen. Scrollen Sie durch den Inhalt, und erstellen Sie ggf. mehr als einen Screenshot, um die gesamte Nachricht zu erfassen.

Wenn Sie Screenshots anfügen, geben Sie die Uhrzeit (oder einen geschätzten Zeitraum) an, zu der Sie die Screenshots erstellt haben. Es wird uns bei der Untersuchung des Problems helfen.

Bestimmte Browser unterstützen das Anzeigen von Zeitstempeln auf der Registerkarte "Konsole ". Öffnen Sie für Chromium Edge/Chrome das Dialogfeld "Einstellungen" in den Entwicklertools, und aktivieren Sie "Zeitstempel anzeigen" auf der Registerkarte "Einstellungen".

Problem mit der Notebook-Websocket-Verbindung

Symptom

Fehlermeldung wird angezeigt: Your notebook connection has closed unexpectedly. To re-establish the connection, run the notebook again. Diagnostic information: websocket_close_error (correlation id)

Grundursache:

Die Ausführung des Notizbuchs hängt davon ab, eine WebSocket-Verbindung mit der folgenden URL herzustellen:

wss://{workspace}.dev.azuresynapse.net/jupyterApi/versions/1/sparkPools/{spark-pool}/api/kernels/{kernel-id}/channels 

• {workspace} ist der Name des Synapse-Arbeitsbereichs.
• {spark-pool} ist der Name des Spark-Pools, an dem Sie gerade arbeiten
• {kernel-id} ist eine GUID, die zum Unterscheiden von Notebook-Sitzungen verwendet wird.

Beim Einrichten der WebSocket-Verbindung enthält Synapse Studio ein Zugriffstoken (Microsoft Entra-JWT-Bearertoken) im Sec-WebSocket-Protocol-Header der WebSocket-Anforderung.

Manchmal wird die WebSocket-Anforderung blockiert, oder das JWT im Anforderungsheader wird in Ihrer Netzwerkumgebung entfernt. Dies führt dazu, dass Synapse Notebook die Verbindung mit unserem Server nicht herstellen und Ihr Notebook ausführen kann.

Aktion:

Versuchen Sie nach Möglichkeit, Ihre Netzwerkumgebung zu wechseln, z. B. innerhalb oder außerhalb des Unternehmensnetzwerks, oder greifen Sie auf einer anderen Arbeitsstation auf Synapse Notebook zu.

• Wenn Sie Notizbuch auf derselben Arbeitsstation, aber in einer anderen Netzwerkumgebung ausführen können, arbeiten Sie mit Ihrem Netzwerkadministrator zusammen, um herauszufinden, ob die WebSocket-Verbindung blockiert wurde.

• Wenn Sie Notizbuch auf einer anderen Arbeitsstation, aber in derselben Netzwerkumgebung ausführen können, stellen Sie sicher, dass Sie kein Browser-Plug-In installiert haben, das die WebSocket-Anforderung möglicherweise blockiert.

Wenden Sie sich andernfalls an Ihren Netzwerkadministrator, und stellen Sie sicher, dass die ausgehenden WebSocket-Anforderungen mit dem folgenden URL-Muster zulässig sind und derEn Anforderungsheader nicht redigiert ist: wss://{workspace}.dev.azuresynapse.net/{path}

• {workspace} ist der Name des Synapse-Arbeitsbereichs
• {path} gibt jeden Unterpfad an (z. B. ist das Schrägstrich-Zeichen enthalten) in der URI.

Dieses URL-Muster ist lockerer als der im Abschnitt "Root Cause" gezeigte, da es uns ermöglicht, in Zukunft neue webSocket-abhängige Features zu Synapse hinzuzufügen, ohne ein potenzielles Verbindungsproblem zu verursachen.

Die Nachrichtenwarteschlange ist voll oder abgeschlossen und kann keine weiteren Elemente mehr annehmen.

Symptom

Wenn Sie ein Notizbuch mit mehr als 256 Codezellen zu einer Pipeline hinzufügen, schlägt die Pipeline mit dem Fehlercode 6002 fehl und es erscheint die Fehlermeldung: MessageQueueFullException: The message queue is full or is completed and cannot accept more items.

Grundursache:

Es gibt eine Beschränkung von 256 Zellen beim Ausführen einer Synapse-Notebookaktivität aus einer Pipeline.

Aktion:

Sie können Zellen zusammenführen, um die Anzahl der Zellen auf unter 256 zu reduzieren.

Nächster Schritt

Wenn die vorherigen Schritte nicht zur Lösung Ihres Problems beitragen, erstellen Sie ein Supportticket.