Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
genie 内の コマンド グループには、Genie のコマンドが含まれています。 「 ジーニー空間とは」を参照してください。
databricks ジーニー メッセージ作成
会話に新しいメッセージを作成します。 AI 応答では、会話内で以前に作成されたすべてのメッセージを使用して応答します。
databricks genie create-message SPACE_ID CONVERSATION_ID CONTENT [flags]
Arguments
SPACE_ID
会話が開始される Genie Space に関連付けられている ID。
CONVERSATION_ID
会話に関連付けられている ID。
CONTENT
ユーザー メッセージの内容。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--no-wait
COMPLETED 状態になるまで待つ必要はありません。
--timeout duration
完了状態に達するまでの最大時間 (デフォルトは20分0秒)。
Examples
次の例では、会話にメッセージを作成します。
databricks genie create-message abc123 conv456 "What were our sales last quarter?"
次の例では、JSON 構成でメッセージを作成します。
databricks genie create-message abc123 conv456 "Show me top customers" --json '{"additional_context": "Include revenue data"}'
次の例では、完了を待たずにメッセージを作成します。
databricks genie create-message abc123 conv456 "Analyze customer trends" --no-wait
databricks genie create-space
Genie Space を作成します。
databricks genie create-space WAREHOUSE_ID SERIALIZED_SPACE [flags]
Arguments
WAREHOUSE_ID
スペースに関連付ける SQL ウェアハウスの ID。
SERIALIZED_SPACE
シリアル化された領域の構成。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、Genie Space を作成します。
databricks genie create-space my-warehouse-id '{}' --json @space-config.json
databricks genie delete-conversation
Genie Space から会話を削除します。
databricks genie delete-conversation SPACE_ID CONVERSATION_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
CONVERSATION_ID
削除する会話の ID。
オプション
Examples
次の例では、会話を削除します。
databricks genie delete-conversation abc123 conv456
databricks genie delete-conversation-message
Genie Space 内の会話からメッセージを削除します。
databricks genie delete-conversation-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
CONVERSATION_ID
会話の ID。
MESSAGE_ID
削除するメッセージの ID。
オプション
Examples
次の例では、メッセージを削除します。
databricks genie delete-conversation-message abc123 conv456 msg789
Databricks Genie 実行メッセージ添付クエリ
メッセージ クエリ添付ファイルの SQL を実行します。 このコマンドは、クエリの添付ファイルの有効期限が切れ、再実行する必要がある場合に使用します。
databricks genie execute-message-attachment-query SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]
Arguments
SPACE_ID
Genie Space ID。
CONVERSATION_ID
会話 ID。
MESSAGE_ID
メッセージ ID。
ATTACHMENT_ID
添付ファイル ID。
オプション
Examples
次の例では、メッセージ添付クエリを実行します。
databricks genie execute-message-attachment-query abc123 conv456 msg789 attach001
databricks genie generate-download-full-query-result
メッセージ添付ファイルの完全なクエリ結果のダウンロードを生成します。
databricks genie generate-download-full-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
CONVERSATION_ID
会話の ID。
MESSAGE_ID
メッセージの ID。
ATTACHMENT_ID
添付ファイルの ID。
オプション
Examples
次の例では、完全なクエリ結果のダウンロードが生成されます。
databricks genie generate-download-full-query-result abc123 conv456 msg789 attach001
databricks genie genie-create-eval-run
Genie Space の評価実行を作成します。
databricks genie genie-create-eval-run SPACE_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、評価実行を作成します。
databricks genie genie-create-eval-run abc123 --json @eval-config.json
databricks genie genie-get-eval-result-details
評価結果の詳細を取得します。
databricks genie genie-get-eval-result-details SPACE_ID EVAL_RUN_ID RESULT_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
EVAL_RUN_ID
評価実行の ID。
RESULT_ID
評価結果の ID。
オプション
Examples
次の例では、評価結果の詳細を取得します。
databricks genie genie-get-eval-result-details abc123 run456 result789
databricks genie genie-get-eval-run
Genie Space の評価実行を取得します。
databricks genie genie-get-eval-run SPACE_ID EVAL_RUN_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
EVAL_RUN_ID
評価実行の ID。
オプション
Examples
次の例では、評価実行を取得します。
databricks genie genie-get-eval-run abc123 run456
databricks genie genie-list-eval-results
評価実行の評価結果を一覧表示します。
databricks genie genie-list-eval-results SPACE_ID EVAL_RUN_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
EVAL_RUN_ID
評価実行の ID。
オプション
--page-size int
ページごとに返される評価結果の最大数。
--page-token string
結果の次のページを取得する不透明なトークン。
Examples
次の例では、評価結果の一覧を示します。
databricks genie genie-list-eval-results abc123 run456
databricks genie genie-list-eval-runs
Genie Space の評価実行を一覧表示します。
databricks genie genie-list-eval-runs SPACE_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
オプション
--page-size int
ページごとに返される評価実行の最大数。
--page-token string
結果の次のページを取得するトークン。
Examples
評価の実行の一覧を次の例に示します。
databricks genie genie-list-eval-runs abc123
databricks genie get-download-full-query-result
以前に生成された完全なクエリ結果のダウンロードを取得します。
databricks genie get-download-full-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID DOWNLOAD_ID DOWNLOAD_ID_SIGNATURE [flags]
Arguments
SPACE_ID
Genie Space の ID。
CONVERSATION_ID
会話の ID。
MESSAGE_ID
メッセージの ID。
ATTACHMENT_ID
添付ファイルの ID。
DOWNLOAD_ID
ダウンロードの ID。
DOWNLOAD_ID_SIGNATURE
ダウンロード ID の署名。
オプション
Examples
次の例では、完全なクエリ結果のダウンロードを取得します。
databricks genie get-download-full-query-result abc123 conv456 msg789 attach001 dl001 sig001
databricks genie get-message
会話からメッセージを取得します。
databricks genie get-message SPACE_ID CONVERSATION_ID MESSAGE_ID [flags]
Arguments
SPACE_ID
ターゲットの会話が配置されている Genie Space に関連付けられている ID。
CONVERSATION_ID
ターゲットの会話に関連付けられている ID。
MESSAGE_ID
識別された会話からのターゲット メッセージに関連付けられている ID。
オプション
Examples
次の例では、会話からメッセージを取得します。
databricks genie get-message abc123 conv456 msg789
databricks genie メッセージ添付ファイルクエリの結果を取得する
メッセージにクエリの添付ファイルがある場合は、SQL クエリの結果を取得します。 これは、メッセージにクエリの添付ファイルがあり、メッセージの状態が EXECUTING_QUERY または COMPLETED場合にのみ使用できます。
databricks genie get-message-attachment-query-result SPACE_ID CONVERSATION_ID MESSAGE_ID ATTACHMENT_ID [flags]
Arguments
SPACE_ID
Genie Space ID。
CONVERSATION_ID
会話 ID。
MESSAGE_ID
メッセージ ID。
ATTACHMENT_ID
添付ファイル ID。
オプション
Examples
次の例では、メッセージ添付ファイルのクエリ結果を取得します。
databricks genie get-message-attachment-query-result abc123 conv456 msg789 attach001
databricks genie list-conversation-messages
会話内のメッセージを一覧表示します。
databricks genie list-conversation-messages SPACE_ID CONVERSATION_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
CONVERSATION_ID
会話の ID。
オプション
--page-size int
1 ページあたりに返されるメッセージの最大数。
--page-token string
結果の次のページを取得するトークン。
Examples
次の例では、会話内のメッセージを一覧表示します。
databricks genie list-conversation-messages abc123 conv456
databricks genie list-conversations
Genie スペースで会話を一覧表示します。
databricks genie list-conversations SPACE_ID [flags]
Arguments
SPACE_ID
Genie Space の ID。
オプション
--page-size int
ページごとに返される会話の最大数。
--page-token string
結果の次のページを取得するトークン。
Examples
次の例では、スペース内の会話を一覧表示します。
databricks genie list-conversations abc123
databricks genie list-spaces
ワークスペース内の Genie Spaces を一覧表示します。
databricks genie list-spaces [flags]
オプション
--page-size int
1 ページあたりに返すスペースの最大数。
--page-token string
結果の次のページを取得するための改ページ トークン。
Examples
次の例では、すべての Genie Spaces を一覧表示します。
databricks genie list-spaces
databricks genie send-message-feedback
Genie の会話でメッセージに関するフィードバックを送信します。
databricks genie send-message-feedback SPACE_ID CONVERSATION_ID MESSAGE_ID RATING [flags]
Arguments
SPACE_ID
Genie Space の ID。
CONVERSATION_ID
会話の ID。
MESSAGE_ID
メッセージの ID。
RATING
メッセージのフィードバック評価。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、メッセージに対して肯定的なフィードバックを送信します。
databricks genie send-message-feedback abc123 conv456 msg789 POSITIVE
databricks genie get-space
Genie Space の詳細を取得します。
databricks genie get-space SPACE_ID [flags]
Arguments
SPACE_ID
Genie Space に関連付けられている ID。
オプション
Examples
次の例では、Genie Space の詳細を取得します。
databricks genie get-space abc123
databricks genie 会話を開始
新しい会話を開始します。
databricks genie start-conversation SPACE_ID CONTENT [flags]
Arguments
SPACE_ID
会話を開始する Genie Space に関連付けられている ID。
CONTENT
会話を開始するメッセージのテキスト。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
--no-wait
COMPLETED 状態になるまで待つ必要はありません。
--timeout duration
完了状態に達するまでの最大時間 (デフォルトは20分0秒)。
Examples
次の例では、新しい会話を開始します。
databricks genie start-conversation abc123 "What are our top performing products this month?"
次の例では、JSON 構成との会話を開始します。
databricks genie start-conversation abc123 "Show me sales data" --json '{"context": "Q4 2024"}'
次の例では、完了を待たずに会話を開始します。
databricks genie start-conversation abc123 "Analyze customer behavior" --no-wait
databricks genie trash-space
Genie Space をごみ箱に移動します。
databricks genie trash-space SPACE_ID [flags]
Arguments
SPACE_ID
ごみ箱に入る Genie スペースの ID。
オプション
Examples
次の例では、Genie Space をごみ箱に入れます。
databricks genie trash-space abc123
databricks genie update-space
Genie Space を更新します。
databricks genie update-space SPACE_ID [flags]
Arguments
SPACE_ID
更新する Genie Space の ID。
オプション
--json JSON
要求本文を含む JSON ファイルに対するインライン JSON 文字列または @path。
Examples
次の例では、Genie Space を更新します。
databricks genie update-space abc123 --json '{"title": "Updated Space Title"}'
グローバル フラグ
--debug
デバッグ ログを有効にするかどうかを指定します。
-h または --help
Databricks CLI、または関連コマンド グループ、または関連コマンドのヘルプの表示。
--log-file 文字列
出力ログを書き込むファイルを表す文字列。 このフラグが指定されていない場合、既定では stderr に出力ログが書き込まれます。
--log-format 形式
ログ形式の種類、 text 、または json。 既定値は text です。
--log-level 文字列
ログ形式レベルを表す文字列。 指定しない場合、ログ形式レベルは無効になります。
-o, --output 型
コマンド出力の種類( text または json)。 既定値は text です。
-p, --profile 文字列
コマンドの実行に使用する ~/.databrickscfg ファイル内のプロファイルの名前。 このフラグが指定されていない場合は、存在する場合は、 DEFAULT という名前のプロファイルが使用されます。
--progress-format 形式
進行状況ログを表示する形式: default、 append、 inplace、または json
-t, --target 文字列
該当する場合は、使用するバンドル ターゲット