gcp-dataform-rest-api-deploy

gcp-dataform-rest-api-deploy は何をしますか？

Claude Codeスキル: .sqlxファイルをGoogle Cloud DataformへREST API経由でデプロイ — 全ライフサイクルと落とし穴ドキュメント付き

概要

このスキルを使用すると、開発者は.sqlxファイルをGoogle Cloud DataformのREST APIを介して自動的にデプロイできます。完全なライフサイクル管理をサポートし、デプロイプロセスにおける一般的な落とし穴とその回避策をドキュメント化しています。

前提条件

• Google Cloudプロジェクトが設定済みであること
• Dataformが有効化されていること
• 適切なIAM権限（dataform.repositories.commit、dataform.workspaces.pushなど）
• Claude Code環境

使用方法

1. .sqlxファイルを準備します。
2. スキルを呼び出してファイルをDataformリポジトリにデプロイします。
3. デプロイステータスを確認します。

コマンド例

# デプロイの実行（例）
claude code deploy --file path/to/your.sqlx

アーキテクチャ

flowchart LR
    A[.sqlxファイル] -->|REST API| B[Google Cloud Dataform]
    B --> C[リポジトリ]
    C --> D[ワークスペース]
    D --> E[コミット]
    E --> F[プッシュ]

落とし穴と回避策

1. APIレート制限

• 問題: 大量のファイルを同時にデプロイするとレート制限に達する
• 回避策: バッチ処理と指数バックオフリトライを実装

2. ファイル名の競合

• 問題: 同じ名前の.sqlxファイルが存在すると上書きされる
• 回避策: 一意のファイル名を使用するか、バージョン管理戦略を採用

3. 権限不足

• 問題: 適切なIAMロールがないとデプロイが失敗する
• 回避策: dataform.adminロールを付与する

ライフサイクル

1. 準備: .sqlxファイルの検証と変換
2. デプロイ: REST APIを使用してDataformにプッシュ
3. 確認: デプロイステータスの監視とログ記録
4. ロールバック: 必要に応じて以前のバージョンに戻す

サポート

問題が発生した場合は、GitHubリポジトリでIssueを開いてください。

ライセンス

MIT