Problemen met Synapse Studio oplossen

Deze probleemoplossingsgids bevat instructies over welke informatie u moet opgeven bij het openen van een ondersteuningsticket bij problemen met de netwerkverbinding. Met de juiste informatie kunnen we het probleem mogelijk sneller oplossen.

Publiceren mislukt wanneer de sessie niet actief blijft

Symptoom

In sommige gevallen, als uw browsersessie gedurende een langere periode inactief is geweest, kan uw poging om te publiceren mislukken vanwege een bericht over het verlopen van tokens:

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

Hoofdoorzaak en beperking

Het afhandelen van het verlopen van tokens in Synapse Studio vereist zorgvuldige overwegingen, met name wanneer u werkt in een livewerkruimte zonder Git-integratie. U kunt als volgt uw sessie beheren om verlies van werk te voorkomen:

• Met Git-integratie:
  • Voer regelmatig uw wijzigingen door. Dit zorgt ervoor dat zelfs als u uw browser moet vernieuwen om uw sessie te vernieuwen, uw werk veilig wordt opgeslagen.
  • Na het doorvoeren kunt u uw browser vernieuwen om de sessie opnieuw in te stellen en vervolgens uw wijzigingen te blijven publiceren.
• Zonder Git-integratie:
  • Voordat u pauzes of perioden van inactiviteit neemt, probeert u de wijzigingen te publiceren. Het is van cruciaal belang om te onthouden dat als uw sessie lange tijd niet actief is geweest, er mogelijk een verloopfout voor het token optreedt wanneer u probeert te publiceren bij het retourneren.
  • Als u zich zorgen maakt over het risico dat niet-opgeslagen wijzigingen verloren gaan vanwege een vereiste vernieuwing, kunt u overwegen om uw werkperioden te structureren om frequente acties voor opslaan en publiceren op te nemen en te voorkomen dat de sessie gedurende langere perioden inactief blijft.

Belangrijk

Als u in een livewerkruimte zonder Git merkt dat uw sessie inactief is en u te maken hebt met een verlooptijd van een token, ziet u een dilemma: vernieuw de pagina en riskeer niet-opgeslagen wijzigingen of probeer te publiceren als het token nog niet is verlopen. Als u dit risico wilt minimaliseren, probeert u actieve sessies te bewaren of regelmatig op te slaan, afhankelijk van de aard van uw werk en de installatie van de omgeving.

Connectiviteitsprobleem met serverloze SQL-poolservice

Symptoom 1

De optie Serverloze SQL-pool wordt grijs weergegeven in de vervolgkeuzelijst 'Verbinding maken naar'.

Symptoom 2

Als u de query uitvoert met 'serverloze SQL-pool', krijgt u het foutbericht 'Kan geen verbinding maken met server'.

Stappen voor probleemoplossing

Notitie

De volgende stappen voor probleemoplossing zijn voor Chromium Edge en Chrome. U kunt andere browsers (zoals FireFox) gebruiken met dezelfde stappen voor probleemoplossing, maar het venster Ontwikkelhulpprogramma heeft mogelijk een andere indeling dan de schermopnamen in deze TSG. Gebruik indien mogelijk geen klassieke Edge voor probleemoplossing, omdat deze mogelijk onjuiste informatie in een bepaalde situatie weergeeft.

Open het deelvenster Diagnostische gegevens en selecteer de knop Diagnostische gegevens downloaden. Bewaar de gedownloade informatie voor foutrapportage. U kunt in plaats daarvan de sessie-id kopiëren en bijvoegen bij het openen van het ondersteuningsticket.

Als u wilt beginnen met het oplossen van problemen, voert u de bewerking die u in Synapse Studio hebt uitgevoerd opnieuw uit.

• Voor symptoom 1 selecteert u de knop Vernieuwen rechts van de vervolgkeuzelijst Database gebruiken op het tabblad SQL-script en controleert u of u 'serverloze SQL-pool' kunt zien.
• Voor symptoom 2 voert u de query opnieuw uit om te zien of deze wordt uitgevoerd.

Als het probleem nog steeds bestaat, drukt u op F12 in uw browser om 'Ontwikkelhulpprogramma's' (DevTools) te openen.

Schakel in het venster Ontwikkelhulpprogramma's over naar het deelvenster Netwerk. Selecteer indien nodig de knop Wissen op de werkbalk in het deelvenster Netwerk. Zorg ervoor dat 'Cache uitschakelen' in het deelvenster 'Netwerk' is ingeschakeld.

Voer de bewerking die u hebt uitgevoerd opnieuw uit in Azure Synapse Studio. Mogelijk ziet u nieuwe items die worden weergegeven in de lijst 'Netwerk' in 'Ontwikkelhulpprogramma's'. Noteer uw huidige systeemtijd om in het ondersteuningsticket op te geven.

Zoek het item waarvan de URL-kolom overeenkomt met het volgende patroon:

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

Waarbij [A] de naam van uw werkruimte is en '-ondemand' '-sqlod' kan zijn en waarbij [B] een databasenaam moet zijn, zoals 'master'. Er moeten maximaal twee items zijn met dezelfde URL-waarde, maar verschillende methodewaarden; OPTIES en POST. Controleer of deze twee items '200' of '20x' hebben onder de statuskolom, waarbij 'x' één cijfer kan zijn.

Als een van beide iets anders heeft dan '20x' en:

• De status begint met '(mislukt)', verbreedt de kolom Status of plaats de muisaanwijzer op de statustekst om de volledige tekst weer te geven. Neem de tekst en/of schermopname op bij het openen van het ondersteuningsticket.

  

  • Als u ERR_NAME_NOT_RESOLVED ziet en u uw werkruimte binnen 10 minuten hebt gemaakt, wacht u tien minuten en probeert u opnieuw of het probleem nog steeds bestaat.
  • Als u ERR_INTERNET_DISCONNECTED of ERR_NETWORK_CHANGED ziet, kan dit duiden op problemen met uw pc-netwerkverbinding. Controleer de netwerkverbinding en voer de bewerking opnieuw uit.
  • Als u ERR_CONNECTION_RESET, ERR_SSL_PROTOCOL_ERROR of andere foutcodes met SSL ziet, kan dit duiden op problemen met uw lokale SSL-configuratie of heeft uw netwerkbeheerder de toegang tot de serverloze SQL-poolserver geblokkeerd. Open een ondersteuningsticket en voeg de foutcode toe aan de beschrijving.
  • Als u ERR_NETWORK_ACCESS_DENIED ziet, moet u mogelijk contact opnemen met de beheerder of uw lokale firewallbeleid de toegang tot *.database.windows.net-domein of externe poort 1443 heeft geblokkeerd.
  • Probeer desgewenst dezelfde bewerking onmiddellijk op een andere computer en/of netwerkomgeving uit om een netwerkconfiguratieprobleem op uw pc uit te sluiten.

• De status is '40x', '50x' of andere getallen, selecteer de items om de details te bekijken. U ziet nu de details van het item aan de rechterkant. Zoek de sectie Antwoordheader; controleer vervolgens of er een item met de naam 'access-control-allow-origin' bestaat. Zo ja, controleert u of deze een van de volgende waarden heeft:

  • * (enkel sterretje)
  • https://web.azuresynapse.net/ (of een andere waarde waarmee de tekst in de adresbalk van de browser begint)

Als de antwoordheader een van de bovenstaande waarden bevat, betekent dit dat we de foutinformatie al moeten hebben verzameld. U kunt indien nodig een ondersteuningsticket openen en eventueel de schermopname van de itemdetails bijvoegen.

Als u de koptekst niet ziet of als de koptekst geen van de bovenstaande waarden bevat, voegt u een schermopname van de itemgegevens toe wanneer u het ticket opent.

Als de bovenstaande stappen uw probleem niet oplossen, moet u mogelijk een ondersteuningsticket openen. Wanneer u uw ondersteuningsticket indient, moet u de sessie-id of diagnostische gegevens opnemen die aan het begin van deze handleiding zijn gedownload.

Wanneer u het probleem meldt, kunt u eventueel een schermopname maken van het tabblad Console in de 'Ontwikkelhulpprogramma's' en deze koppelen aan het ondersteuningsticket. Schuif door de inhoud en neem indien nodig meer dan één schermopname om het hele bericht vast te leggen.

Als u schermopnamen bijvoegt, geeft u de tijd (of het geschatte tijdsbereik) op van wanneer u de schermafbeeldingen hebt gemaakt. Het helpt ons bij het onderzoeken van het probleem.

Bepaalde browsers ondersteunen het weergeven van tijdstempels op het tabblad Console. Voor Chromium Edge/Chrome opent u het dialoogvenster 'Instellingen' in 'Ontwikkelhulpprogramma's' en schakelt u 'Tijdstempels weergeven' in op het tabblad Voorkeuren.

Verbindingsprobleem met notebook-websocket

Symptoom

Er wordt een foutbericht weergegeven: uw notitieblokverbinding is onverwacht gesloten. Als u de verbinding opnieuw tot stand wilt brengen, voert u het notebook opnieuw uit. Diagnostische gegevens: websocket_close_error (correlatie-id)

Hoofdoorzaak:

Uitvoering van notebooks is afhankelijk van het tot stand brengen van een WebSocket-verbinding met de volgende URL

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

• {workspace} is de naam van de Synapse-werkruimte,
• {spark-pool} is de naam van de Spark-pool waaraan u momenteel werkt,
• {kernel-id} is een GUID die wordt gebruikt voor het onderscheiden van notebooksessies.

Bij het instellen van een WebSocket-verbinding bevat Synapse Studio een toegangstoken (JWT bearer-token) in de Sec-WebSocket-Protocol-header van de WebSocket-aanvraag.

Soms kan de WebSocket-aanvraag worden geblokkeerd of kan het JWT-token in de aanvraagheader worden bewerkt in uw netwerkomgeving. Hierdoor kan Synapse Notebook de verbinding met onze server niet tot stand brengen en uw notebook uitvoeren.

Actie:

Probeer indien mogelijk over te schakelen naar uw netwerkomgeving, zoals binnen/buiten corpnet, of open Synapse Notebook op een ander werkstation.

• Als u notebooks op hetzelfde werkstation kunt uitvoeren, maar in een andere netwerkomgeving, neemt u contact op met de netwerkbeheerder om erachter te komen of de WebSocket-verbinding is geblokkeerd.

• Als u notebooks op een ander werkstation kunt uitvoeren, maar in dezelfde netwerkomgeving, moet u ervoor zorgen dat u geen browserinvoegtoepassing hebt geïnstalleerd die de WebSocket-aanvraag kan blokkeren.

Neem anders contact op met uw netwerkbeheerder en zorg ervoor dat de uitgaande WebSocket-aanvragen met het volgende URL-patroon zijn toegestaan en dat de aanvraagheader niet wordt bewerkt:

wss://{workspace}.dev.azuresynapse.net/{path} 

• {workspace} is de naam van de Synapse-werkruimte;

• {path} geeft aan dat een subpad (bijvoorbeeld slash-teken is opgenomen) in de URI.

Dit URL-patroon is losser dan het patroon dat wordt weergegeven in de sectie Hoofdoorzaak, omdat we in de toekomst nieuwe WebSocket-afhankelijke functies kunnen toevoegen aan Synapse zonder mogelijk connectiviteitsprobleem.

Berichtenwachtrij vol of is voltooid en kan niet meer items accepteren

Symptoom

Als u een notebook toevoegt dat meer dan 256 codecellen aan een pijplijn bevat, mislukken pijplijnuitvoeringen met de foutcode 6002 en foutbericht: "MessageQueueFullException: De berichtenwachtrij is vol of is voltooid en kan niet meer items accepteren."

Hoofdoorzaak:

Er is een beperking van 256 cellen bij het uitvoeren van een Synapse-notebookactiviteit vanuit een pijplijn.

Actie:

U kunt cellen samenvoegen om het aantal cellen onder de 256 te beperken.

Volgende stappen

Als de vorige stappen niet helpen om het probleem op te lossen: Een ondersteuningsticket maken