Problemen met Synapse Studio oplossen

Deze gids voor probleemoplossing 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.
  • Nadat u de sessie hebt doorgevoerd, kunt u uw browser vernieuwen om de sessie opnieuw in te stellen en vervolgens uw wijzigingen 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, u mogelijk een token-verloopfout tegenkomt wanneer u probeert te publiceren wanneer u terugkomt.
  • 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.

Connectiviteitsprobleem met serverloze SQL-poolservice

Symptoom 1

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

Symptoom 2

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

Stappen voor probleemoplossing

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 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 Developer Tools (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 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

Waar *A* is de naam van uw werkruimte en kan zijn -ondemand en -sqlod waar *B* moet een databasenaam zijn, zoals master. Er moeten maximaal twee items zijn met dezelfde URL-waarde, maar verschillende methodewaarden; OPTIONS 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:

• Status begint met '(mislukt)', verbreed de kolom Status of beweeg de muisaanwijzer over 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 erop wijzen dat uw pc-netwerkverbinding problemen ondervindt. 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 erop wijzen dat uw lokale SSL-configuratie problemen ondervindt of dat de netwerkbeheerder de toegang tot de serverloze SQL-poolserver heeft 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.

• Status kan 40x, 50x of een ander nummer zijn, selecteer het item voor meer details. 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 deze 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 niet over een van deze waarden beschikt, voegt u een schermopname van de itemdetails 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 het tabblad Voorkeuren in.

Verbindingsprobleem met notebook-websocket

Symptoom

Er wordt een foutbericht weergegeven: Your notebook connection has closed unexpectedly. To re-establish the connection, run the notebook again. Diagnostic information: websocket_close_error (correlation id)

Hoofdoorzaak:

De uitvoering van een notebook 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 (Microsoft Entra JWT bearer-token) in de sec-WebSocket-Protocol header van de WebSocket-aanvraag.

Soms kunnen WebSocket-aanvragen worden geblokkeerd, of kan JWT in de verzoekheader worden verwijderd 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 de notebook op hetzelfde werkstation kunt uitvoeren maar in een andere netwerkomgeving, moet u contact opnemen met uw netwerkbeheerder om uit te zoeken of de WebSocket-verbinding is geblokkeerd.

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

Neem anders contact op met de 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 een subpad aan (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.

De berichtenwachtrij is vol of voltooid en kan geen extra items accepteren.

Symptoom

Als u een notebook toevoegt dat meer dan 256 codecellen bevat aan een pijplijn, mislukken pijplijnuitvoeringen met de foutcode 6002 en het foutbericht: MessageQueueFullException: The message queue is full or is completed and cannot accept more items.

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 stap

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