Snowflake API IntegrationsでExternal Function連携を構築する方法

API Integrationは、SnowflakeからExternal Function経由で外部のREST APIを 安全に呼び出すための認証・接続設定オブジェクトです。 AWS API Gateway、Azure API Management、Google Cloud API Gatewayとの統合をサポートし、 SQLクエリの中からML推論・ジオコーディング・翻訳などの外部サービスを直接利用できます。

API Integration × External Functionのアーキテクチャ

API Integrationは、SnowflakeのCloud Services LayerとクラウドプロバイダーのAPI Gateway間の認証チャネルを確立するオブジェクトです。実際のデータフローは以下の通りです。

SQLクエリ
  → Virtual Warehouse (External Function呼び出し)
    → Cloud Services Layer (API Integration認証)
      → API Gateway (AWS / Azure / GCP)
        → バックエンド (Lambda / Azure Functions / Cloud Functions)
          → レスポンスをSnowflakeに返却

API Integrationが担うのは「Snowflakeのサービスアカウント ↔ API Gatewayのアクセス制御」の信頼関係の確立です。実際のHTTPリクエスト送信はExternal Functionが行います。

AWS向けAPI Integrationの作成

-- AWS API Gateway用のAPI Integration
CREATE OR REPLACE API INTEGRATION aws_ml_api
  API_PROVIDER = aws_api_gateway
  API_AWS_ROLE_ARN = 'arn:aws:iam::123456789012:role/snowflake-api-role'
  API_ALLOWED_PREFIXES = ('https://abc123.execute-api.us-east-1.amazonaws.com/prod/')
  ENABLED = TRUE;

-- 作成後にSnowflakeのIAM情報を取得
DESCRIBE INTEGRATION aws_ml_api;
-- → API_AWS_IAM_USER_ARN と API_AWS_EXTERNAL_ID を確認
-- → AWS側のIAMロール信頼ポリシーにこれらを設定

AWS IAMロール信頼ポリシーの設定

{
  "Version": "2012-10-17",
  "Statement": [{
    "Effect": "Allow",
    "Principal": {
      "AWS": "<API_AWS_IAM_USER_ARN>"
    },
    "Action": "sts:AssumeRole",
    "Condition": {
      "StringEquals": {
        "sts:ExternalId": "<API_AWS_EXTERNAL_ID>"
      }
    }
  }]
}

Azure向けAPI Integrationの作成

-- Azure API Management用のAPI Integration
CREATE OR REPLACE API INTEGRATION azure_translate_api
  API_PROVIDER = azure_api_management
  AZURE_TENANT_ID = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890'
  AZURE_AD_APPLICATION_ID = 'f1e2d3c4-b5a6-7890-abcd-ef0987654321'
  API_ALLOWED_PREFIXES = ('https://my-apim.azure-api.net/translate/')
  ENABLED = TRUE;

-- DESCRIBE INTEGRATIONでAZURE_MULTI_TENANT_APP_NAMEを取得
-- Azure AD側でサービスプリンシパルに権限を付与

GCP向けAPI Integrationの作成

-- Google Cloud API Gateway用のAPI Integration
CREATE OR REPLACE API INTEGRATION gcp_geocode_api
  API_PROVIDER = google_api_gateway
  GOOGLE_AUDIENCE = 'https://my-gateway-abc123.uc.gateway.dev'
  API_ALLOWED_PREFIXES = ('https://my-gateway-abc123.uc.gateway.dev/geocode/')
  ENABLED = TRUE;

-- DESCRIBE INTEGRATIONでAPI_GCP_SERVICE_ACCOUNTを取得
-- GCP側でこのサービスアカウントにInvoker権限を付与

クラウド別設定比較表

External Functionの作成と呼び出し

-- External Functionを作成してAPI Integrationを紐付け
CREATE OR REPLACE EXTERNAL FUNCTION sentiment_analysis(text VARCHAR)
  RETURNS VARIANT
  API_INTEGRATION = aws_ml_api
  AS 'https://abc123.execute-api.us-east-1.amazonaws.com/prod/sentiment';

-- SQLクエリ内でExternal Functionを呼び出し
SELECT
  review_id,
  review_text,
  sentiment_analysis(review_text) AS sentiment_result
FROM product_reviews
LIMIT 100;

-- バッチ処理: INSERT INTO ... SELECT で結果を永続化
INSERT INTO product_reviews_enriched
SELECT
  review_id,
  review_text,
  sentiment_analysis(review_text):sentiment::VARCHAR AS sentiment,
  sentiment_analysis(review_text):confidence::FLOAT AS confidence
FROM product_reviews;

セキュリティ設計のポイント

• API_ALLOWED_PREFIXESを最小限に：ワイルドカード的に広いプレフィックスを指定せず、必要なエンドポイントパスのみを許可する
• API_BLOCKED_PREFIXESで追加制御：許可プレフィックス内の特定パスを除外したい場合に使用する
• USAGE権限の管理：API Integrationに対するUSAGE権限をGRANTするロールを限定し、不要なロールからは取り消す
• バックエンド側の認証も併用：API Gateway側でもAPIキーやOAuth2トークン検証を設定し、多層防御を構築する

API Integrationの管理コマンド

-- 一覧表示
SHOW API INTEGRATIONS;

-- 詳細確認
DESCRIBE INTEGRATION aws_ml_api;

-- 無効化（External Functionの呼び出しが全てブロックされる）
ALTER API INTEGRATION aws_ml_api SET ENABLED = FALSE;

-- 再有効化
ALTER API INTEGRATION aws_ml_api SET ENABLED = TRUE;

-- 削除（参照するExternal Functionを先に削除する必要あり）
DROP API INTEGRATION aws_ml_api;

トラブルシューティング

問題で確認

よくある質問