A Synapse Studio hibaelhárítása

Ez a hibaelhárítási útmutató útmutatást nyújt arról, hogy milyen információkat kell megadni a támogatási jegy hálózati csatlakozási problémák esetén történő megnyitásakor. A megfelelő információk birtokában gyorsabban megoldhatjuk a problémát.

A közzététel sikertelen, ha a munkamenet tétlen marad

Tünet

Bizonyos esetekben, ha a böngésző munkamenete hosszabb ideje inaktív, a közzétételi kísérlet meghiúsulhat a jogkivonat lejáratáról szóló üzenet miatt:

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

Alapvető okok és kockázatcsökkentés

A jogkivonatok lejáratának kezelése a Synapse Studióban gondos megfontolást igényel, különösen akkor, ha git-integráció nélküli élő munkaterületen dolgozik. A munkamenet kezelése a munka elvesztésének elkerülése érdekében:

• Git-integrációval:
  • A módosítások rendszeres véglegesítése. Ez biztosítja, hogy még ha frissítenie is kell a böngészőt a munkamenet megújításához, a rendszer biztonságosan tárolja a munkáját.
  • A véglegesítés után frissítheti a böngészőt a munkamenet alaphelyzetbe állításához, majd a módosítások közzétételéhez.
• Git-integráció nélkül:
  • Szünetek vagy inaktivitási időszakok megkezdése előtt próbálja meg közzétenni a módosításokat. Fontos megjegyezni, hogy ha a munkamenet hosszú ideje tétlen, a visszatéréskor a közzétételkor jogkivonat-lejárati hibát tapasztalhat.
  • Ha aggódik amiatt, hogy a szükséges frissítés miatt elveszítheti a nem mentett módosításokat, fontolja meg a munkaidőszakok strukturálását, hogy a gyakori mentési és közzétételi műveleteket is tartalmazza, és ne hagyja tétlenül a munkamenetet hosszabb ideig.

Fontos

Egy Git nélküli élő munkaterületen, ha úgy találja, hogy a munkamenet tétlen volt, és jogkivonat-lejárattal szembesül, dilemmával szembesül: frissítse a lapot, és kockáztatja a nem mentett módosítások elvesztését, vagy próbálja meg közzétenni, ha a jogkivonat még nem járt le. A kockázat minimalizálása érdekében próbálja meg megtartani az aktív munkameneteket, vagy mentsen gyakran a munka jellegétől és a környezet beállításától függően.

Kiszolgáló nélküli SQL-készletszolgáltatás csatlakozási problémája

1. tünet

A "Kiszolgáló nélküli SQL-készlet" lehetőség szürkítve jelenik meg a "Csatlakozás" legördülő menüben.

2. tünet

Ha a lekérdezést kiszolgáló nélküli SQL-készlettel futtatja, a "Nem sikerült kapcsolatot létesíteni a kiszolgálóval" hibaüzenet jelenik meg.

Hibaelhárítási lépések

Feljegyzés

A következő hibaelhárítási lépések a Chromium Edge-hez és a Chrome-hoz tartoznak. Más böngészőket (például a FireFoxot) is használhat ugyanezekkel a hibaelhárítási lépésekkel, de a "Fejlesztői eszköz" ablak elrendezése eltérhet a jelen TSG képernyőképeitől. Ha lehetséges, NE használja a klasszikus Edge-t a hibaelhárításhoz, mivel bizonyos helyzetekben pontatlan információkat jeleníthet meg.

Nyissa meg a "Diagnosztikai adatok" panelt, és válassza a "Diagnosztikai adatok letöltése" gombot. Tartsa meg a letöltött információkat a hibajelentéshez. Ehelyett másolhatja a "Munkamenet-azonosítót", és csatolhatja a támogatási jegy megnyitásakor.

A hibaelhárítás megkezdéséhez próbálkozzon újra a Synapse Studióban végrehajtott művelettel.

• Az 1. tünet esetén válassza az "Adatbázis használata" legördülő menü jobb oldalán található "Frissítés" gombot az "SQL-szkript" lapon, és ellenőrizze, hogy látható-e a "kiszolgáló nélküli SQL-készlet".
• A 2. hibajelenség esetén próbálkozzon újra a lekérdezés futtatásával, és ellenőrizze, hogy sikeresen végrehajtja-e.

Ha a probléma továbbra is fennáll, nyomja le az F12 billentyűt a böngészőben a "Fejlesztői eszközök" (DevTools) megnyitásához.

A "Fejlesztői eszközök" ablakban váltson a "Hálózat" panelre. Szükség esetén válassza a "Törlés" gombot a "Hálózat" panel eszköztárán. Győződjön meg arról, hogy a "Gyorsítótár letiltása" jelölőnégyzet be van jelölve a "Hálózat" panelen.

Próbálkozzon újra az Azure Synapse Studióban végrehajtott művelettel. A "Fejlesztői eszközök" "Hálózat" listájában megjelenhetnek az új elemek. Jegyezze fel a támogatási jegyben megadott aktuális rendszeridőt.

Keresse meg azt az elemet, amelynek URL-oszlopa megegyezik a következő mintával:

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

Ahol az [A] a munkaterület neve, a "-ondemand" pedig "-sqlod" lehet, és ahol [B] adatbázisnévnek kell lennie, például "master". Legfeljebb két elemnek kell lennie ugyanazzal az URL-értékkel, de eltérő metódusértékekkel; BEÁLLÍTÁSOK és POST. Ellenőrizze, hogy ez a két elem "200" vagy "20x" értékkel rendelkezik-e az állapotoszlop alatt, ahol az "x" bármely számjegy lehet.

Ha bármelyikük rendelkezik a "20x" és a következőhöz hasonlóval:

• Az állapot a következővel kezdődik: "(sikertelen)", vagy szélesítse az "Állapot" oszlopot, vagy vigye az egérmutatót az állapotszöveg fölé a teljes szöveg megtekintéséhez. A támogatási jegy megnyitásakor adja meg a szöveget és/vagy a képernyőképet.

  

  • Ha ERR_NAME_NOT_RESOLVED lát, és 10 percen belül létrehozta a munkaterületet, várjon 10 percet, és próbálkozzon újra, hogy a probléma továbbra is fennáll-e.
  • Ha ERR_INTERNET_DISCONNECTED vagy ERR_NETWORK_CHANGED jelenik meg, az azt jelezheti, hogy a számítógép hálózati kapcsolata problémákat tapasztal. Ellenőrizze a hálózati kapcsolatot, és próbálkozzon újra a művelettel.
  • Ha ERR_CONNECTION_RE Standard kiadás T, ERR_SSL_PROTOCOL_ERROR vagy más" SSL-t tartalmazó hibakód jelenik meg, az azt jelezheti, hogy a helyi SSL-konfiguráció problémái vannak, vagy a hálózati rendszergazda letiltotta a kiszolgáló nélküli SQL-készletkiszolgálóhoz való hozzáférést. Nyisson meg egy támogatási jegyet, és csatolja a hibakódot a leíráshoz.
  • Ha ERR_NETWORK_ACCESS_DENIED lát, előfordulhat, hogy ellenőriznie kell a rendszergazdával, hogy a helyi tűzfalszabályzat letiltotta-e a hozzáférést a *.database.windows.net tartományhoz vagy az 1443-at tartalmazó távoli porthoz.
  • Ha szeretné, próbálja meg azonnal ugyanazt a műveletet egy másik gépen és/vagy hálózati környezetben, hogy kizárja a számítógép hálózati konfigurációs problémáját.

• Az állapot "40x", "50x" vagy más szám, válassza ki az elem(ek)et a részletek megtekintéséhez. Az elem részleteit jobbra kell látnia. Keresse meg a "Válaszfejléc" szakaszt; ezután ellenőrizze, hogy létezik-e "access-control-allow-origin" nevű elem. Ha igen, ellenőrizze, hogy a következő értékek egyikével rendelkezik-e:

  • * (egy csillag)
  • https://web.azuresynapse.net/ (vagy más érték, amellyel a böngésző címsorában lévő szöveg kezdődik)

Ha a válaszfejléc a fenti értékek egyikét tartalmazza, az azt jelenti, hogy már összegyűjtöttük a hibainformációkat. Szükség esetén megnyithat egy támogatási jegyet, és opcionálisan csatolhatja az elem részleteinek képernyőképét.

Ha nem látja a fejlécet, vagy az élőfej nem rendelkezik a fent felsorolt értékek egyikével, csatoljon egy képernyőképet az elem részleteiről a jegy megnyitásakor.

Ha a fenti lépések nem oldják meg a problémát, előfordulhat, hogy meg kell nyitnia egy támogatási jegyet. A támogatási jegy elküldésekor adja meg az útmutató elején letöltött "Munkamenet-azonosítót" vagy "Diagnosztikai adatokat".

A probléma bejelentésekor szükség esetén képernyőképet készíthet a "Konzol" lapról a "Fejlesztői eszközök" területen, és csatolhatja a támogatási jegyhez. Görgessen végig a tartalomon, és szükség esetén készítsen több képernyőképet a teljes üzenet rögzítéséhez.

Ha képernyőképeket csatol, adja meg a képernyőképek készítésének idejét (vagy becsült időtartományát). Segít nekünk, ha megnézzük a problémát.

Egyes böngészők támogatják az időbélyegek megjelenítését a "Konzol" lapon. A Chromium Edge/Chrome esetében nyissa meg a "Gépház" párbeszédpanelt a "Fejlesztői eszközök" területen, és jelölje be az "Időbélyegek megjelenítése" lehetőséget a Beállítások lapon.

Notebook websocket kapcsolati probléma

Tünet

Hibaüzenet jelenik meg: a jegyzetfüzet-kapcsolat váratlanul bezárult. A kapcsolat újbóli létrehozásához futtassa újra a jegyzetfüzetet. Diagnosztikai információk: websocket_close_error (korrelációs azonosító)

Kiváltó ok:

A jegyzetfüzet végrehajtása a WebSocket-kapcsolat létrehozásának függvénye az alábbi URL-címhez

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

• {workspace} a Synapse-munkaterület neve,
• {spark-pool} a jelenleg használt Spark-készlet neve,
• {kernel-id} A jegyzetfüzet-munkamenetek megkülönböztetésére használt GUID.

A WebSocket-kapcsolat beállításakor a Synapse Studio egy hozzáférési jogkivonatot (JWT-tulajdonosi jogkivonatot) fog tartalmazni a WebSocket-kérés Sec-WebSocket-Protocol fejlécében.

Előfordulhat, hogy a WebSocket-kérés le van tiltva, vagy a kérelem fejlécében lévő JWT-jogkivonat újra ki lesz léptetve a hálózati környezetben. Ez azt eredményezi, hogy a Synapse Notebook nem tudja létrehozni a kapcsolatot a kiszolgálóval, és futtatni a jegyzetfüzetet.

Művelet:

Ha lehetséges, próbálja meg átváltani a hálózati környezetet, például a külső/belső hálózatot, vagy elérni a Synapse Notebookot egy másik munkaállomáson.

• Ha ugyanazon a munkaállomáson, de más hálózati környezetben is futtathat jegyzetfüzetet, a hálózati rendszergazdával együttműködve állapítsa meg, hogy a WebSocket-kapcsolat le lett-e tiltva.

• Ha egy másik munkaállomáson, de ugyanabban a hálózati környezetben futtathat jegyzetfüzetet, győződjön meg arról, hogy nem telepített olyan böngésző beépülő modult, amely blokkolhatja a WebSocket-kérést.

Ellenkező esetben forduljon a hálózati rendszergazdához, és győződjön meg arról, hogy a kimenő WebSocket-kérések engedélyezettek az alábbi URL-mintával, és a kérés fejléce nem lesz újraküldve:

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

• {workspace} a Synapse-munkaterület neve;

• {path} az URI bármely alútvonalát (azaz perjel karakterét) jelzi.

Ez az URL-minta lazább, mint a "Kiváltó ok" szakaszban látható, mert lehetővé teszi, hogy új WebSocket-függő funkciókat adjunk hozzá a Synapse-hoz anélkül, hogy a jövőben bármilyen csatlakozási probléma merülhet fel.

Az üzenetsor megtelt vagy befejeződött, és nem tud több elemet fogadni

Tünet

Ha egy folyamathoz több mint 256 kódcellát tartalmazó jegyzetfüzetet ad hozzá, a folyamatfuttatások a 6002-es hibakóddal meghiúsulnak, és a következő hibaüzenet jelenik meg: "MessageQueueFullException: Az üzenetsor megtelt vagy befejeződött, és nem tud több elemet elfogadni."

Kiváltó ok:

A Synapse-jegyzetfüzet-tevékenységek folyamatból való végrehajtásakor 256 cella van korlátozva.

Művelet:

Egyesítheti a cellákat a 256 alatti cellák számának csökkentése érdekében.

Következő lépések

Ha az előző lépések nem segítenek megoldani a problémát , hozzon létre egy támogatási jegyet