Trino CLI

Trino CLI for HDInsight on AKS には、クエリを実行するためのターミナル ベースの対話型シェルが用意されています。

Windows へのインストール

Windows では、MSI を使用して Trino CLI for HDInsight on AKS がインストールされるので、Windows コマンド プロンプト (CMD) または PowerShell から CLI にアクセスできます。 Linux 用 Windows サブシステム (WSL) 向けにインストールする場合は、「Linux へのインストール」を参照してください。

必要条件

• Java 8 または 11。

• PATH に java.exe を追加するか、JRE インストール ディレクトリーを指す JAVA_HOME 環境変数を %JAVA_HOME%\bin\java.exe が存在するように定義します。

インストールまたは更新

MSI パッケージは、Windows で Trino CLI for HDInsight on AKS をインストールまたは更新するために使用されます。

Trino CLI の最新のリリースをダウンロードしてインストールします。 インストーラーによって、コンピューターに変更を加えるかどうかを尋ねるメッセージが表示されたら、[はい] をクリックします。 インストールが完了したら、Trino CLI を使用するには、アクティブな Windows コマンド プロンプトまたは PowerShell のウィンドウを閉じてから再度開く必要があります。

Trino CLI のダウンロード: https://aka.ms/InstallTrinoCLIWindows

Trino CLI を実行する

コマンド プロンプトで "trino-cli" を使用して Trino CLI を実行し、クラスターに接続できます。

trino-cli --server <cluster_endpoint>

トラブルシューティング

ここでは、Windows に Trino CLI をインストールする際に発生する一般的な問題をいくつか示します。

プロキシによる接続のブロック

プロキシにより接続がブロックされているため MSI インストーラーをダウンロードできない場合、プロキシを正しく構成していることを確認します。 Windows 10 の場合、これらの設定は、[設定] > [ネットワークとインターネット] > [プロキシ] ペインで管理されます。 必要な設定またはお使いのマシンの構成が管理されている状況や高度なセットアップが必要な状況については、システム管理者にお問い合わせください。

MSI を取得するには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。

• https://aka.ms/
• https://hdionaksresources.blob.core.windows.net/

アンインストール

Windows の "アプリと機能" の一覧から Trino CLI をアンインストールできます。 アンインストールするには、次のようにします。

この画面に移動したら、プログラムの検索バーに "Trino" と入力します。 アンインストールするプログラムは、"HDInsight Trino CLI <バージョン>" として表示されます。 このアプリケーションを選択し、[アンインストール] ボタンをクリックします。

Linux をインストールする

Trino CLI には、クエリを実行するためのターミナル ベースの対話型シェルが用意されています。 [インストール スクリプト] オプションを選択して、Trino CLI を Linux に手動でインストールできます。

必要条件

• Java 8 または 11。

• PATH に java を追加するか、JRE インストール ディレクトリーを指す JAVA_HOME 環境変数を $JAVA_HOME/bin/java が存在するように定義します。

インストールまたは更新

CLI をインストールおよび更新するには、いずれの場合もインストール スクリプトを再実行する必要があります。 curl を実行して CLI をインストールします。

curl -L https://aka.ms/InstallTrinoCli | bash

スクリプトをダウンロードして、ローカルで実行することもできます。 変更を有効にするために、シェルの再起動が必要になる場合があります。

Trino CLI を実行する

シェルから "trino-cli" コマンドを使用して Trino CLI を実行し、クラスターに接続できます。

trino-cli --server <cluster_endpoint>

トラブルシューティング

ここでは、手動インストール中に発生する一般的な問題をいくつか示します。

curl の "Object Moved" エラー

curl で -L パラメーターに関連するエラーが発生した場合や、"Object Moved" というテキストが含まれているエラー メッセージが表示された場合は、次のように、aka.ms リダイレクトの代わりに完全な URL を使用してみてください。

curl https://hdionaksresources.blob.core.windows.net/trino/cli/install.sh | bash

trino-cli コマンドが見つからない

hash -r

インストール後にシェルを再起動しなかった場合にも、この問題が発生することがあります。 trino-cli コマンドの場所 ($HOME/bin) が $PATH にあることを確認します。

プロキシによる接続のブロック

インストール スクリプトを取得するには、プロキシで次のアドレスへの HTTPS 接続を許可する必要があります。

• https://aka.ms/
• https://hdionaksresources.blob.core.windows.net/

Uninstall

すべての trino-cli ファイルを削除するには、次のコマンドを実行します。

rm $HOME/bin/trino-cli
rm -r $HOME/lib/trino-cli

認証

Trino CLI では、コマンド ライン パラメーターを使用した Microsoft Entra 認証のさまざまな方法がサポートされています。 次の表は、重要なパラメータと認証方法について説明するものです。詳細については、認証に関する記事を参照してください。

CLI でも使用できるパラメーターの説明:

trino-cli --help

例

トラブルシューティング

MissingAccessToken または InvalidAccessToken

CLI には、次のいずれかのエラーが表示されます。

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"
}]

この問題を解決するには、次の手順をお試しください。

1. Trino CLI を終了します。
2. az logout を実行します。
3. az login -t <your-trino-cluster-tenantId> を実行します。
4. これで、このコマンドが機能します。

trino-cli --server <cluster-endpoint>

5. または、認証/テナント パラメーターを指定します。

trino-cli --server <cluster-endpoint> --auth AzureInteractive --azure-tenant <trino-cluster-tenantId>

403 無効

CLI に次のエラーが表示されます。

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>
]

この問題を解決するには、承認プロファイルにユーザーまたはグループを追加します。