Trinó parancssori felület
Fontos
Ez a szolgáltatás jelenleg előzetes kiadásban elérhető. A Microsoft Azure Előzetes verzió kiegészítő használati feltételei további jogi feltételeket tartalmaznak, amelyek a bétaverzióban, előzetes verzióban vagy egyébként még nem általánosan elérhető Azure-funkciókra vonatkoznak. Erről az adott előzetes verzióról az Azure HDInsight az AKS előzetes verziójában tájékozódhat. Ha kérdése vagy funkciójavaslata van, küldjön egy kérést az AskHDInsightban a részletekkel együtt, és kövessen minket további frissítésekért az Azure HDInsight-közösségről.
Az AKS-en futó HDInsighthoz készült Trino CLI terminálalapú, interaktív felületet biztosít a lekérdezések futtatásához.
Telepítés Windows rendszeren
Windows esetén az AKS-en a HDInsighthoz készült Trino CLI egy MSI-n keresztül van telepítve, amely hozzáférést biztosít a parancssorhoz a Windows parancssorán (CMD) vagy a PowerShellen keresztül. A Linuxos Windows-alrendszer (WSL) telepítésekor lásd: Telepítés Linuxon.
Követelmények
Adjon hozzá java.exe a PATH-hoz, vagy definiáljon JAVA_HOME környezeti változót, amely a JRE telepítési könyvtárára mutat, például létezik
%JAVA_HOME%\bin\java.exe.
Telepítés vagy frissítés
Az MSI-csomag a HDInsighthoz készült Trino CLI windowsos AKS-en való telepítéséhez vagy frissítéséhez használható.
Töltse le és telepítse a Trino CLI legújabb kiadását. Amikor a telepítő engedélyt kér a számítógépen végzett módosítások végrehajtására, kattintson az „Igen” lehetőségre. A telepítés befejezése után be kell zárnia és újra meg kell nyitnia minden aktív Windows parancssort vagy PowerShell-ablakot a trinói parancssor használatához.
Töltse le a Trino parancssori felületét: https://aka.ms/InstallTrinoCLIWindows
A Trino parancssori felületének futtatása
Most már futtathatja a Trino CLI-t a parancssorban a "trino-cli" paranccsal, és csatlakozhat a fürthöz:
trino-cli --server <cluster_endpoint>
Feljegyzés
Ha fej nélküli operációs rendszeren fut (webböngésző nélkül), a Trino CLI kérni fogja, hogy használjon eszközkódot a hitelesítéshez. Megadhatja a parancssori paramétert --auth AzureDeviceCode is, amely az eszközkód használatával kényszeríthető. Ebben az esetben meg kell nyitnia egy böngészőt egy másik eszközön/operációs rendszeren, be kell adnia a megjelenített kódot és hitelesítenie kell, majd vissza kell térnie a parancssori felületre.
Hibaelhárítás
Íme néhány gyakori probléma a Trino CLI Windows rendszeren való telepítésekor.
Proxy letiltja a kapcsolatot
Ha nem tudja letölteni az MSI-telepítőt, mert a proxy blokkolja a kapcsolatot, győződjön meg arról, hogy a proxy megfelelően van konfigurálva. Windows 10 esetén ezeket a beállításokat a Gépház > Hálózat & internetproxy > panelen kezeli a rendszer. Forduljon a rendszergazdához a szükséges beállításokért, vagy olyan helyzetekért, amikor a gép konfigurációval kezelhető, vagy speciális beállításokat igényel.
Az MSI beszerzéséhez a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címekre:
https://aka.ms/https://hdionaksresources.blob.core.windows.net/
Eltávolítás
A Trino parancssori felületét eltávolíthatja a Windows "Alkalmazások és szolgáltatások" listájából. Eltávolítás:
| Platform | Utasítások |
|---|---|
| Windows 10 | Gépház > alkalmazás indítása > |
| Windows 8 és Windows 7 | Program eltávolítása Vezérlőpult > programok > indítása > |
Ezen a képernyőn írja be a Trinót a program keresősávjába. Az eltávolítandó program a "HDInsight Trino CLI-verzió<>" lista. Jelölje ki ezt az alkalmazást, majd kattintson az Eltávolítás gombra.
Telepítés Linux rendszeren
A Trino CLI terminálalapú, interaktív rendszerhéjat biztosít a lekérdezések futtatásához. A Trino CLI linuxos telepítéséhez válassza a Szkript telepítése lehetőséget.
Követelmények
Adjon hozzá java-t a PATH-hoz, vagy definiáljon JAVA_HOME környezeti változót, amely a JRE telepítési könyvtárára mutat, így $JAVA_HOME/bin/java létezik.
Telepítés vagy frissítés
A parancssori felület telepítéséhez és frissítéséhez újra kell futtatni a telepítési szkriptet. Telepítse a parancssori felületet a curl futtatásával.
curl -L https://aka.ms/InstallTrinoCli | bash
A szkript letölthető, és helyileg is futtatható. Lehetséges, hogy a módosítások érvénybe léptetéséhez újra kell indítania a felületet.
A Trino parancssori felületének futtatása
Most már futtathatja a Trino CLI-t a "trino-cli" paranccsal a rendszerhéjból, és csatlakozhat a fürthöz:
trino-cli --server <cluster_endpoint>
Feljegyzés
Ha fej nélküli operációs rendszeren fut (nincs webböngésző), a Trino CLI kérni fogja, hogy használjon eszközkódot a hitelesítéshez. Megadhatja a parancssori paramétert --auth AzureDeviceCode is, amely az eszközkód használatával kényszeríthető. Ebben az esetben meg kell nyitnia egy böngészőt egy másik eszközön/operációs rendszeren, be kell adnia a megjelenített kódot és hitelesítenie kell, majd vissza kell térnie a parancssori felületre.
Hibaelhárítás
Az alábbiakban néhány gyakori, a manuális telepítés során jelentkező problémáról olvashat.
curl "Object Moved" hiba
Ha az -L paraméterrel kapcsolatos curl-hiba vagy az "Áthelyezett objektum" szöveget tartalmazó hibaüzenet jelenik meg, a aka.ms átirányítás helyett a teljes URL-címet próbálja meg használni:
curl https://hdionaksresources.blob.core.windows.net/trino/cli/install.sh | bash
a trino-cli parancs nem található
hash -r
Ez a probléma akkor is előfordulhat, ha a telepítést követően nem indította újra a felületet. Győződjön meg arról, hogy a trino-cli parancs ($HOME/bin) helye a $PATH.
Proxy letiltja a kapcsolatot
A telepítési szkriptek beszerzéséhez a proxynak engedélyeznie kell a HTTPS-kapcsolatokat a következő címekre:
https://aka.ms/https://hdionaksresources.blob.core.windows.net/
Eltávolítás
Az összes trino-cli fájl eltávolításához futtassa a következőt:
rm $HOME/bin/trino-cli
rm -r $HOME/lib/trino-cli
Hitelesítés
A Trino CLI parancssori paraméterekkel támogatja a Microsoft Entra-hitelesítés különböző módszereit. Az alábbi táblázat a fontos paramétereket és hitelesítési módszereket ismerteti, további információkért lásd : Hitelesítés.
A parancssori felületen elérhető paraméterek leírása:
trino-cli --help
| Paraméter | Értelmezés | Kötelező | Leírás |
|---|---|---|---|
| auth | A hitelesítési módszer neve | Nem | Meghatározza a felhasználói hitelesítő adatok megadásának módját. Ha nincs megadva, a parancsot használja AzureDefault. |
| azure-client | Ügyfél azonosítója | Igen a AzureClientSecret, AzureClientCertificate. |
A szolgáltatásnév/alkalmazás ügyfélazonosítója. |
| azure-tenant | Bérlőazonosító | Igen a AzureClientSecret, AzureClientCertificate. |
Microsoft Entra-bérlőazonosító. |
| azure-certificate-path | A tanúsítvány elérési útja | Igen a AzureClientCertificate. |
A pfx/pem fájl elérési útja tanúsítvánnyal. |
| azure-use-token-cache | Jogkivonat-gyorsítótár használata vagy sem | Nem | Ha meg van adva, a hozzáférési jogkivonat gyorsítótárazva lesz, és mód szerint AzureDefault, AzureInteractive, AzureDeviceCode újra felhasználható. |
| azure-scope | Jogkivonat hatóköre | Nem | Microsoft Entra hatókörsztring, amellyel jogkivonatot kérhet. |
| use-device-code | Eszközkód metódus használata vagy sem | Nem | Egyenértékű a --auth AzureDeviceCode. |
| jelszó | Ügyfélkód a szolgáltatásnévhez | Igen a AzureClientSecret. |
Titkos kód/jelszó a szolgáltatásnévhez a mód használatakor AzureClientSecret . |
| hozzáférési jogkivonat | JWT hozzáférési jogkivonat | Nem | Ha a hozzáférési jogkivonatot külsőleg szerezték be, ezt a paramétert használhatja. Ebben az esetben auth a paraméter nem engedélyezett. |
Példák
| Leírás | Parancssori felületi parancs |
|---|---|
| AzureDefault | trino-cli --server cluster1.pool1.region.projecthilo.net |
| Interaktív böngészőhitelesítés | trino-cli --server cluster1.pool1.region1.projecthilo.net --auth AzureInteractive |
| Jogkivonat-gyorsítótár használata | trino-cli --server cluster1.pool1.region1.projecthilo.net --auth AzureInteractive --azure-use-token-cache |
| Szolgáltatásnév titkos kóddal | trino-cli --server cluster1.pool1.region1.projecthilo.net --auth AzureClientSecret --azure-client 11111111-1111-1111-1111-111111111111 --azure-tenant 11111111-1111-1111-1111-111111111111 --password |
| Szolgáltatásnév és védett tanúsítvány (a jelszó kérése) | trino-cli --server cluster1.pool1.region1.projecthilo.net --auth AzureClientCertificate --azure-client 11111111-1111-1111-1111-111111111111 --azure-certificate-path d:\tmp\cert.pfx --azure-tenant 11111111-1111-1111-1111-111111111111 --password |
Hibaelhárítás
MissingAccessToken vagy InvalidAccessToken
A parancssori felület a következő hibák valamelyikét jeleníti meg:
Error running command: Authentication failed: {
"code": "MissingAccessToken",
"message": "Unable to find the token or get the required claims from it."
}
Error running command: Error starting query at https://<cluster-endpoint>/v1/statement returned an invalid response: JsonResponse{statusCode=500, statusMessage=, headers={content-type=[application/json; charset=utf-8], date=[Fri, 16 Jun 2023 18:25:23 GMT], strict-transport-security=[max-age=15724800; includeSubDomains]}, hasValue=false} [Error: {
"code": "InvalidAccessToken",
"message": "Unable to find the token or get the required claims from it"
}]
A probléma megoldásához próbálkozzon az alábbi lépésekkel:
- Lépjen ki a Trino parancssori felületről.
- Az
az logoutparancs futtatása - Az
az login -t <your-trino-cluster-tenantId>parancs futtatása - Most a parancsnak működnie kell:
trino-cli --server <cluster-endpoint>
- Másik lehetőségként adja meg a hitelesítési/bérlői paramétereket:
trino-cli --server <cluster-endpoint> --auth AzureInteractive --azure-tenant <trino-cluster-tenantId>
403 – Tiltott
A parancssori felület hibaüzenetet jelenít meg:
Error running command: Error starting query at https://<cluster-endpoint>/v1/statement returned an invalid response: JsonResponse{statusCode=403, statusMessage=, headers={content-length=[146], content-type=[text/html], date=[Wed, 25 May 2023 16:49:24 GMT], strict-transport-security=[max-age=15724800; includeSubDomains]}, hasValue=false} [Error: <html>
<head><title>403 Forbidden</title></head>
<body>
<center><h1>403 Forbidden</h1></center>
<hr><center>nginx</center>
</body>
</html>
]
A probléma megoldásához adjon hozzá felhasználót vagy csoportot az engedélyezési profilhoz.