> ## Documentation Index
> Fetch the complete documentation index at: https://docs.auxia.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Snowflake (Secure Data Sharing)

> Snowflake セキュアデータ共有によるデータ連携の設定

<Note>
  日本語版はAIによる翻訳です。正確な情報については[英語版](/data-ingestion/data-connections/snowflake/data-sharing)をご参照ください。
</Note>

このガイドでは、Snowflake の [セキュアデータ共有](https://docs.snowflake.com/en/user-guide/data-sharing-intro) を使って、Auxia がデータを**その場で**読み取る方法を説明します。テーブルのエクスポート・コピー・再作成は不要で、お客様側でスケジュールジョブを実行する必要もありません。

<Note>
  Snowflake を Auxia に連携する際の推奨方法は [Direct Connection](/ja/data-ingestion/data-connections/snowflake/direct-connection) です。お客様のアカウント上の読み取り専用ロールを通じて、Auxia がテーブルをその場で読み取ります。セキュアデータ共有は、お客様のアカウントが Auxia と**同一のクラウド・リージョン**にある場合に適した代替手段です（クロスリージョン・クロスクラウドの共有にはレプリケーションが必要です）。選択する前に Auxia のソリューションエンジニアにご確認ください。
</Note>

事前に [ソースデータ要件](/ja/data-ingestion/overview#source-data-requirements) を確認し、テーブルが Auxia と連携できる状態であることをご確認ください。

## 1. 概要

Auxia に読み取らせたいテーブルまたはビューの**共有（share）**を作成し、Auxia の Snowflake アカウントをコンシューマーとして追加します。以降は Auxia が**自身のウェアハウス**を使い、定期スケジュールで共有から**読み取り専用**でデータを取得します。そのため、お客様側で実行・保守するコンピュートやスケジュールタスクはありません。

**フロー:**

```
お客様の Snowflake アカウント                     Auxia
      │
      │  テーブル / セキュアビュー
      │       │
      │       │  share に GRANT し、Auxia をコンシューマーに ADD
      │       ▼
      │   Share ──(読み取り専用アクセス)──>
      │                                    │
      │                                    │  Auxia がスケジュールに従い
      │                                    │  共有から増分読み取り
      │                                    │  （Auxia のウェアハウス）
      │                                    ▼
      │                                Auxia プラットフォーム
```

**所要時間:** 約 10 分。

**前提条件:**

* `ACCOUNTADMIN` ロール（共有の作成およびコンシューマーアカウントの追加に必要）。
* Auxia の Snowflake アカウントが、お客様と**同じクラウド・同じリージョン**にあること（セキュアデータ共有の要件）。異なる場合は Snowflake の [レプリケーション](https://docs.snowflake.com/en/user-guide/secure-data-sharing-across-regions-platforms) が必要です。担当の Auxia ソリューションエンジニアがご案内します（お客様側にレプリケーションのコストが発生します）。
* 各共有テーブル/ビューに、行の追加・更新日時を示す**タイムスタンプ列**（例: `UPDATE_DATE`）があること。これにより Auxia は全件再スキャンではなく増分読み取りが可能になります。

**Auxia が提供するもの:** Auxia の **Snowflake アカウント識別子**（共有に追加するコンシューマー）。また、接続の構成とスケジュール（初回の履歴ロードおよび定期的な増分読み取り）を Auxia 側で行い、ソースに対して行数を検証します。本番稼働前に担当のソリューションエンジニアが接続を確認します。

## 2. 共有（Share）を作成する

`ACCOUNTADMIN` ロールを選択したワークシートで以下を実行します。Auxia に読み取らせたいデータベース・スキーマ・テーブル/ビューごとにアクセス権を付与してください。

```sql theme={null}
CREATE SHARE IF NOT EXISTS auxia_share;

GRANT USAGE  ON DATABASE <your_database>                          TO SHARE auxia_share;
GRANT USAGE  ON SCHEMA   <your_database>.<your_schema>           TO SHARE auxia_share;

-- 公開するオブジェクトごとに繰り返します:
GRANT SELECT ON TABLE    <your_database>.<your_schema>.<table>   TO SHARE auxia_share;
-- ビューを共有する場合は SECURE VIEW を推奨します:
GRANT SELECT ON VIEW     <your_database>.<your_schema>.<view>    TO SHARE auxia_share;
```

## 3. Auxia をコンシューマーとして追加する

Auxia から Snowflake の**アカウント識別子**をお渡しします。これを共有に追加してください。

```sql theme={null}
ALTER SHARE auxia_share ADD ACCOUNTS = <auxia_account_identifier>;
```

<Note>
  Auxia のアカウントがお客様と**異なるリージョンまたはクラウド**にある場合、この手順の代わりにレプリケーション/リスティングベースの共有が必要です。担当の Auxia ソリューションエンジニアが正確な手順をご案内します。
</Note>

## 4. Auxia に詳細を連絡する

担当の Auxia ソリューションエンジニアに以下を共有してください。

* **共有名**（例: `auxia_share`）
* 取り込み対象の**データベース / スキーマ / テーブル（またはビュー）名**
* 各オブジェクトの**タイムスタンプ列（ウォーターマーク列）**（増分読み取りに使用）
* 希望する**更新頻度**（例: 毎時または毎日）と、ソースデータが通常到着する時刻

Auxia 側で共有をインストールし、合意したスケジュールで各オブジェクトを増分読み取りし、行数を検証したうえで、本番稼働前に確認します。

## 5. コスト

* **お客様側のコンピュートは不要** — Auxia は自身のウェアハウスで読み取るため、読み取りに対する課金はお客様側に発生しません。
* **同一クラウド・同一リージョン内ではデータ egress は発生しません** — セキュアデータ共有はその場で読み取ります。リージョン/クラウドをまたぐ共有にはレプリケーションが必要で、お客様側にストレージおよびレプリケーションのコストが発生します（可能な限り Auxia のアカウントと同一リージョンに配置することで回避できます）。

## 6. まとめ

| ステップ | 作業 | 担当 |
| :- | :- | :- |
| 1 | Snowflake アカウント識別子を提供 | Auxia |
| 2 | 共有を作成しオブジェクトを GRANT | お客様 |
| 3 | Auxia のアカウントをコンシューマーに追加 | お客様 |
| 4 | 共有名・オブジェクト名・ウォーターマーク列を連絡 | お客様 |
| 5 | 共有のインストール、読み取りのスケジュール、検証、確認 | Auxia |

## サポート

[**support@auxia.io**](mailto:support@auxia.io) または担当の Auxia ソリューションエンジニアまでお問い合わせください。
