SnowflakeのGit統合でSQLスクリプトとNotebookをバージョン管理する方法

Snowflake Git Integrationは、GitHub・GitLab等のGitリポジトリを Snowflakeのデータベースオブジェクトとして登録し、リポジトリ内のSQLスクリプト・Pythonファイル・ 設定ファイルをSnowflake内から直接参照・実行できる機能です。 インフラのコード化（IaC）やCI/CDパイプラインの統合に活用でき、 Snowflake Notebookのバージョン管理にも利用できます。

Git統合のセットアップフロー

Step 1: Secret（認証情報）の作成
  ↓
Step 2: API Integration（Git API接続）の作成
  ↓
Step 3: Git Repositoryオブジェクトの作成
  ↓
Step 4: FETCH でリモートと同期
  ↓
Step 5: ファイル参照・スクリプト実行

Step 1: 認証用Secretの作成

-- GitHubのPersonal Access Token (PAT) を格納
CREATE OR REPLACE SECRET git_pat_secret
  TYPE = PASSWORD
  USERNAME = 'github-username'
  PASSWORD = 'ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';

-- パブリックリポジトリの場合はSecretは不要

Step 2: API Integrationの作成

-- GitHub用のAPI Integration
CREATE OR REPLACE API INTEGRATION github_api_integration
  API_PROVIDER = git_https_api
  API_ALLOWED_PREFIXES = ('https://github.com/my-org/')
  ALLOWED_AUTHENTICATION_SECRETS = (git_pat_secret)
  ENABLED = TRUE;

Step 3: Git Repositoryの作成

-- Git Repositoryオブジェクトの作成
CREATE OR REPLACE GIT REPOSITORY analytics_db.public.my_sql_repo
  API_INTEGRATION = github_api_integration
  GIT_CREDENTIALS = git_pat_secret
  ORIGIN = 'https://github.com/my-org/snowflake-sql-scripts.git';

-- パブリックリポジトリの場合（認証なし）
CREATE OR REPLACE GIT REPOSITORY analytics_db.public.public_repo
  API_INTEGRATION = github_api_integration
  ORIGIN = 'https://github.com/my-org/public-scripts.git';

Step 4: リモートリポジトリのフェッチ

-- リモートリポジトリの最新を取得
ALTER GIT REPOSITORY analytics_db.public.my_sql_repo FETCH;

-- ブランチ一覧を確認
SHOW GIT BRANCHES IN analytics_db.public.my_sql_repo;

-- タグ一覧を確認
SHOW GIT TAGS IN analytics_db.public.my_sql_repo;

ファイルの参照

-- mainブランチのファイル一覧
LIST @analytics_db.public.my_sql_repo/branches/main/;

-- 特定ディレクトリのファイル一覧
LIST @analytics_db.public.my_sql_repo/branches/main/sql/transforms/;

-- 特定タグのファイル一覧
LIST @analytics_db.public.my_sql_repo/tags/v1.2.0/;

-- ファイルの内容を読み取り
SELECT $1 AS content
FROM @analytics_db.public.my_sql_repo/branches/main/README.md
(FILE_FORMAT => 'util_db.formats.text_raw');

SQLスクリプトの実行

-- Git Repository内のSQLスクリプトを直接実行
EXECUTE IMMEDIATE FROM
  @analytics_db.public.my_sql_repo/branches/main/sql/create_tables.sql;

-- 特定タグ（バージョン）のスクリプトを実行
EXECUTE IMMEDIATE FROM
  @analytics_db.public.my_sql_repo/tags/v1.2.0/sql/migrations/001_add_columns.sql;

-- 変数を渡してスクリプトを実行
EXECUTE IMMEDIATE FROM
  @analytics_db.public.my_sql_repo/branches/main/sql/parameterized_query.sql
  USING (target_date => '2026-03-27', batch_size => 10000);

Git Repositoryのパス構造

Snowflake Notebookとの連携

Snowsight上のNotebookをGitリポジトリと連携させることで、 NotebookのバージョンがGitで管理されます。

• Snowsight UIからNotebookにGitリポジトリを接続
• ブランチ切り替え・コミット・プッシュをUI上で操作可能
• 複数のデータサイエンティストが同一Notebookをブランチベースで共同編集
• プルリクエストベースのレビューフローをGitHub/GitLab上で実施

CI/CDパイプラインパターン

-- TaskでFETCH → スクリプト実行を自動化
CREATE OR REPLACE TASK daily_deploy
  WAREHOUSE = ops_wh
  SCHEDULE = 'USING CRON 0 6 * * * UTC'
AS
  BEGIN
    ALTER GIT REPOSITORY my_sql_repo FETCH;
    EXECUTE IMMEDIATE FROM
      @my_sql_repo/branches/main/sql/daily_etl.sql;
  END;

ALTER TASK daily_deploy RESUME;

必要な権限

ベストプラクティス

• タグベースのデプロイメント：本番環境ではブランチではなくタグを参照し、特定バージョンのスクリプトを確実に実行する
• 定期的なFETCHをTaskでスケジュール：手動FETCHの漏れを防ぐため、TaskでFETCHを定期実行する
• API_ALLOWED_PREFIXESを制限：API IntegrationのAPI_ALLOWED_PREFIXESで許可するリポジトリの範囲を最小限にする
• Secretのローテーション：Personal Access Tokenには有効期限を設定し、定期的にSecretを更新する

問題で確認

よくある質問