dataproc-skills について
dataproc-skillsは、Google Dataprocのクラスターやジョブを取得・一覧表示するNode.jsスクリプト集です。フィルターとページネーションに対応し、環境変数は.envファイルから自動的に読み込みます。
主な機能
- 01名前によるクラスター取得
- 02IDによるジョブ取得
- 03フィルター付きクラスター一覧
- 04状態条件によるジョブ一覧
- 05クラスターとジョブ結果のページ分割
- 06.envファイルからの環境変数読み込み
活用シーン
- 01Dataprocクラスターの詳細確認
- 02IDによるDataprocジョブの検索
- 03状態やラベルによるクラスター一覧
- 04実行中または完了済みジョブの検索
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cline/ skills --skill dataproc-skillsインストール後、Claude Code で/dataproc-skillsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
scripts/get_cluster.jsget_job.jslist_clusters.jslist_jobs.js詳細
使用方法
すべてのスクリプトは Node.js を使用して実行できます。<param_name> と <param_value> を実際の値に置き換えてください。
Bash:
node <skill_dir>/scripts/<script_name>.js '{"<param_name>": "<param_value>"}'
PowerShell:
node <skill_dir>/scripts/<script_name>.js '{\"<param_name>\": \"<param_value>\"}'
注:スクリプトは、さまざまな .env ファイルから環境変数を自動的に読み込みます。スキルの実行が環境変数の不足により失敗しない限り、ユーザーに変数の設定を求めないでください。
スクリプト
get_cluster
Dataproc クラスターを取得します
パラメーター
| 名前 | 型 | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| clusterName | string | クラスターの短縮名です。たとえば、"projects/my-project/regions/us-central1/clusters/my-cluster" の場合は "my-cluster" を渡します(プロジェクトとリージョンはソースから継承されます) | いいえ |
get_job
Dataproc ジョブを取得します
パラメーター
| 名前 | 型 | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| jobId | string | ジョブ ID です。たとえば、"projects/my-project/regions/us-central1/jobs/my-job" の場合は "my-job" を渡します(プロジェクトとリージョンはソースから継承されます) | いいえ |
list_clusters
Dataproc クラスターを一覧表示して絞り込みます
パラメーター
| 名前 | 型 | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| filter | string | 一覧表示するクラスターを制限するフィルターです。フィルターでは大文字と小文字が区別され、次の構文を使用します:field = value [AND [field = value]] ...。field は status.state、clusterName、または labels.[KEY] のいずれかで、[KEY] はラベルキーです。value に * を指定すると、すべての値に一致します。status.state には、ACTIVE、INACTIVE、CREATING、RUNNING、ERROR、DELETING、UPDATING、STOPPING、STOPPED のいずれかを指定できます。ACTIVE には CREATING、UPDATING、RUNNING の各状態が含まれます。INACTIVE には DELETING、ERROR、STOPPING、STOPPED の各状態が含まれます。clusterName は作成時に指定したクラスター名です。サポートされているのは論理 AND 演算子のみです。スペースで区切られた項目には暗黙的な AND 演算子が適用されます。 | いいえ | |
| pageSize | integer | 1 ページで返されるクラスターの最大数(デフォルトは 20) | いいえ | 20 |
| pageToken | string | 前回の ListClusters 呼び出しで受け取ったページトークン | いいえ |
list_jobs
Dataproc ジョブを一覧表示し、フィルタリングします
パラメーター
| 名前 | 型 | 説明 | 必須 | デフォルト |
|---|---|---|---|---|
| filter | string | 一覧表示するジョブを絞り込むフィルターです。フィルターでは大文字と小文字が区別され、次の構文を使用します。field = value [AND [field = value]] ...。field は clusterName、status.state、または labels.[KEY] で、[KEY] はラベルキーです。すべての値に一致させるには、value に * を指定できます。status.state には、PENDING、RUNNING、CANCEL_PENDING、JOB_STATE_CANCELLED、DONE、ERROR、ATTEMPT_FAILURE のいずれかを指定できます。サポートされる論理演算子は AND のみです。スペースで区切られた項目は、暗黙的に AND 演算子で結合されているものとして扱われます。クエリのパフォーマンスを向上させるため、clusterName によるフィルタリングをおすすめします。 | いいえ | |
| jobStateMatcher | string | ジョブ状態のマッチャーがすべてのジョブ、ACTIVE ジョブのみ、または NON_ACTIVE ジョブのみを対象とするかを指定します。デフォルトは ALL です。サポートされる値は ALL、ACTIVE、NON_ACTIVE です。 | いいえ | |
| pageSize | integer | 1 ページで返すジョブの最大数です(デフォルトは 20)。 | いいえ | 20 |
| pageToken | string | 前回の ListJobs 呼び出しで受け取ったページトークンです。 | いいえ |
コメント
Markdown 対応