Felsökning av Synapse Studio

Den här felsökningsguiden innehåller instruktioner om vilken information som ska tillhandahållas när du öppnar ett supportärende om problem med nätverksanslutningen. Med rätt information kan vi eventuellt lösa problemet snabbare.

Publiceringen misslyckas när sessionen förblir inaktiv

Symtom

I vissa fall kan ditt försök att publicera misslyckas om webbläsarsessionen har varit inaktiv under en längre period på grund av ett meddelande om att token upphör att gälla:

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

Rotorsak och åtgärd

Att hantera utgången av token i Synapse Studio kräver noggrant övervägande, särskilt när du arbetar i en aktiv arbetsyta utan Git-integration. Så här hanterar du sessionen för att undvika att förlora arbete:

• Med Git-integrering:
  • Genomför ändringarna regelbundet. Detta säkerställer att även om du behöver uppdatera webbläsaren för att förnya sessionen lagras ditt arbete på ett säkert sätt.
  • När du har checkat in kan du uppdatera webbläsaren för att återställa sessionen och sedan fortsätta att publicera ändringarna.
• Utan Git-integration:
  • Försök att publicera ändringarna innan du tar pauser eller perioder av inaktivitet. Det är viktigt att komma ihåg att om sessionen har varit inaktiv under en längre tid kan det uppstå ett fel vid förfallodatum för token när du försöker publicera när du återvänder.
  • Om du är orolig för risken att förlora ändringar som inte har sparats på grund av en nödvändig uppdatering kan du överväga att strukturera dina arbetsperioder så att de omfattar frekventa åtgärder för att spara och publicera och undvika att lämna sessionen inaktiv under längre perioder.

Anslutningsproblem med serverlös SQL-pooltjänst

Symtom 1

Alternativet "Serverlös SQL-pool" är nedtonat i listrutan Anslut till .

Symtom 2

När du kör frågan med "serverlös SQL-pool" visas felmeddelandet "Det gick inte att upprätta anslutningen till servern".

Felsökningsanvisningar

Öppna panelen Diagnostikinformation och välj knappen Ladda ned diagnostik . Behåll den nedladdade informationen för felrapportering. Du kan i stället kopiera "Sessions-ID" och bifoga det när du öppnar supportbegäran.

Börja felsöka genom att försöka utföra den åtgärd som du utförde i Synapse Studio igen.

• För symptom 1 väljer du knappen Uppdatera på fliken SQL-skript och kontrollerar om du kan se "serverlös SQL-pool".
• För symptom 2 kan du prova att köra frågan igen för att se om den körs korrekt.

Om problemet kvarstår trycker du på F12 i webbläsaren för att öppna Utvecklarverktyg (DevTools).

I fönstret Utvecklarverktyg växlar du till panelen Nätverk . Välj knappen Rensa i verktygsfältet på panelen Nätverk om det behövs.

Kontrollera att Inaktivera cache pånätverkspanelen är markerat.

Försök utföra åtgärden igen i Azure Synapse Studio. Du kan se nya objekt som visas i listan Nätverk i Utvecklarverktyg. Observera din aktuella systemtid som ska anges i supportärendet.

Leta reda på objektet vars URL-kolumn matchar följande mönster:

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

Var *A* är arbetsytans namn och -ondemand kan vara -sqlod och var *B* ska vara ett databasnamn, till exempel master. Det bör finnas högst två objekt med samma URL-värde men olika metodvärden. OPTIONS och POST. Kontrollera om de här två objekten har 200 eller 20x under statuskolumnen, var x kan det finnas en ensiffrig siffra.

Om någon av dem har något annat än 20x och:

• Statusen börjar med "(failed)", antingen breddar du kolumnen Status eller hovrar pekaren över statustexten för att se den fullständiga texten. Inkludera texten och/eller skärmbilden när du öppnar supportärendet.

  

  • Om du ser ERR_NAME_NOT_RESOLVED och du har skapat din arbetsyta inom 10 minuter väntar du i 10 minuter och försöker se om problemet fortfarande finns.
  • Om du ser ERR_INTERNET_DISCONNECTED eller ERR_NETWORK_CHANGED kan det tyda på att datorns nätverksanslutning har problem. Kontrollera nätverksanslutningen och försök igen.
  • Om du ser ERR_CONNECTION_RESET, ERR_SSL_PROTOCOL_ERROR eller andra felkoder som innehåller "SSL" kan det tyda på att din lokala SSL-konfiguration har problem eller att nätverksadministratören har blockerat åtkomsten till den serverlösa SQL-poolservern. Öppna ett supportärende och bifoga felkoden i beskrivningen.
  • Om du ser ERR_NETWORK_ACCESS_DENIED kan du behöva kontakta administratören om din lokala brandväggsprincip har blockerat åtkomsten till antingen *.database.windows.net domän eller fjärrport 1443.
  • Du kan också prova samma åtgärd omedelbart på en annan dator och/eller nätverksmiljö för att utesluta ett problem med nätverkskonfigurationen på datorn.

• Status är 40x, 50x eller andra siffror, välj objekt för att se detaljerna. Du bör se objektinformationen till höger. Leta reda på avsnittet "Svarshuvud"; kontrollera sedan om det finns ett objekt med namnet "access-control-allow-origin". I så fall kontrollerar du om det har något av följande värden:

  • * (enstaka asterisk)
  • https://web.azuresynapse.net/ (eller annat värde som texten i webbläsarens adressfält börjar med)

Om svarshuvudet innehåller något av dessa värden innebär det att vi redan borde ha samlat in felinformationen. Du kan öppna ett supportärende om det behövs och eventuellt bifoga skärmbilden av objektinformationen.

Om du inte kan se rubriken eller om rubriken inte har något av dessa värden bifogar du en skärmbild av objektinformationen när du öppnar biljetten.

Om stegen ovan inte löser problemet kan du behöva öppna ett supportärende. När du skickar ditt supportärende ska du inkludera "Sessions-ID" eller "Diagnostikinformation" som laddades ned i början av den här guiden.

När du rapporterar problemet kan du ta en skärmbild av fliken Konsol i utvecklarverktygen och bifoga den i supportärendet. Rulla innehållet och ta mer än en skärmbild om det behövs för att samla in hela meddelandet.

Om du kopplar skärmbilder anger du tiden (eller ett uppskattat tidsintervall) för när du tog skärmbilderna. Det hjälper oss när vi undersöker problemet.

Vissa webbläsare stöder visning av tidsstämplar på fliken Konsol . För Chromium Edge/Chrome öppnar du dialogrutan Inställningar i Utvecklarverktyg och markerar "Visa tidsstämplar" på fliken Inställningar.

Problem med anslutning till notebook-webbsocket

Symtom

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

Grundorsak:

Körning av notebooks är beroende av att upprätta en WebSocket-anslutning till följande URL:

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

• {workspace} är namnet på Synapse-arbetsytan
• {spark-pool} är namnet på Den Spark-pool som du arbetar med för närvarande
• {kernel-id} är ett GUID som används för att särskilja notebook-sessioner

När du konfigurerar en WebSocket-anslutning kommer Synapse Studio att inkludera en åtkomsttoken (Microsoft Entra JWT-ägartoken) i Sec-WebSocket-Protocol-huvudet på WebSocket-begäran.

Ibland kan WebSocket-begäran blockeras, eller så kan JWT i begärandehuvudet redigeras i nätverksmiljön. Detta gör att Synapse Notebook inte kan upprätta kontakt med vår server och köra din notebook-fil.

Åtgärd:

Om möjligt kan du försöka byta nätverksmiljö, till exempel inuti/utanför corpnet, eller komma åt Synapse Notebook på en annan arbetsstation.

• Om du kan köra notebook-filen på samma arbetsstation men i en annan nätverksmiljö kan du kontakta nätverksadministratören för att ta reda på om WebSocket-anslutningen har blockerats.

• Om du kan köra notebook-filen på en annan arbetsstation men i samma nätverksmiljö kontrollerar du att du inte har installerat något webbläsar-plugin-program som kan blockera WebSocket-begäran.

Annars kontaktar du nätverksadministratören och ser till att utgående WebSocket-begäranden med följande URL-mönster tillåts och att deras begärandehuvud inte redigeras: wss://{workspace}.dev.azuresynapse.net/{path}

• {workspace} är namnet på Synapse-arbetsytan
• {path} indikerar en delväg (till exempel att snedstreck ingår) i URI

Det här URL-mönstret är lösare än det som visas i avsnittet "Rotorsak" eftersom det gör att vi kan lägga till nya WebSocket-beroende funktioner i Synapse utan några potentiella anslutningsproblem i framtiden.

Meddelandekön är full eller har slutförts och kan inte acceptera fler objekt

Symtom

Om du lägger till en notebook-fil som innehåller fler än 256 kodceller i en pipeline misslyckas pipelinekörningarna med felkoden 6002 och felmeddelandet: MessageQueueFullException: The message queue is full or is completed and cannot accept more items.

Grundorsak:

Det finns en begränsning på 256 celler när du kör en Synapse-anteckningsbokaktivitet från en pipeline.

Åtgärd:

Du kan sammanfoga celler för att minska antalet celler under 256.

Nästa steg

Om föregående steg inte hjälper dig att lösa problemet skapar du en supportbegäran