Snowflake Connector for SharePoint について¶
注釈
Snowflake Connector for SharePoint は `コネクタ規約<https://www.snowflake.com/legal/snowflake-connector-terms/>`_ に従います。
重要
SharePoint 用Snowflakeコネクタにご興味をお持ちいただきありがとうございます。現在、大幅に改善されたエクスペリエンスを提供する次世代のソリューションに焦点を当てています。したがって、このコネクタを一般提供ステータスに移行することは、現在の製品ロードマップにはありません。このコネクタはプレビュー機能として引き続き使用できますが、将来のバグ修正および改善のサポートは保証されないことに注意してください。新しいソリューションは SharePoint 用Openflowコネクタ として利用可能で、より優れたパフォーマンス、カスタマイズ性、強化された展開オプションが含まれます。
このトピックでは、ユースケースと利点、主な機能、仕組み、および制限など、 Snowflake Connector for SharePoint の基本概念について説明します。
Snowflake Connector for SharePoint コネクタは、Microsoft 365 SharePoint サイトとSnowflakeを接続し、ファイルとユーザー権限をインジェストして最新の状態に保ちます。Snowflake Connector for SharePoint Cortex Searchサービスもサポートしており、 SQL、Pythonまたは REST APIs を使用して、インジェストされたファイルを AI アシスタントで使用するための会話分析用に準備することができます。
利点¶
スムーズな取り込み：コネクタの設定と構成は簡単です。お好みのチャットインターフェースでCortex Searchを使用して SharePoint のファイルを使用できます。
デフォルトで安全：コネクタは、Cortex Searchフィルターを通じて SharePoint のエンドユーザーアクセス制御に従います。
スケーラブルな設計：Snowflake Native Appフレームワーク上に構築されたこのコネクタは、Snowflakeの組み込みのセキュリティ、スケーラビリティ、信頼性の機能を活用します。
コストを節約：コネクタを使用すると、手動でファイルを転送したり、 API エンドポイントに統合したり、サードパーティソリューションを管理したりする必要がなくなるため、コストを節約できます。
ユースケース¶
このコネクタは、以下を実行する場合に使用します。
仕組み¶
このセクションでは、前述の2つのユースケースに関してこのコネクタがどのように機能するかを説明します。
組織の SharePoint サイト内のパブリックドキュメント用の AI アシスタントを作成します¶
このユースケースでの Snowflake Connector for SharePoint の操作は、大まかに4つのフェーズに分けられ、それぞれが特定のユーザーペルソナに関連付けられています。次のワークフローでは、これらのフェーズ、関連するユーザーのジャーニー、およびこのコネクタの仕組みについて説明します。
組織内の `AzureまたはOffice 365アカウント管理者<https://learn.microsoft.com/en-us/microsoft-365/admin/add-users/about-admin-roles>`_ は、 `ユーザーなしでアクセスを取得する<https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http>`_ の説明に従って、 OAuth 認証を有効にするように `Microsoft Graph<https://learn.microsoft.com/en-us/graph/overview>`_ を構成します。その後、必要な認証情報を組織のデータエンジニアと共有します。
組織内の データエンジニアまたはデータサイエンティスト が、Snowflake MarketplaceからSnowflake用の SharePoint コネクタを自分のSnowflakeアカウントにインストールします。次に、次の情報でコネクタを構成します。
ステップ1で取得した SharePointOAuth 認証情報（ClientID 、クライアントシークレット、および TenantID）を指定します。
SharePoint サイトの URL を指定します。通常、これは SharePoint サイト内の特定のサブサイトです。
すべてのフォルダーまたは SharePointURL の特定のフォルダーからファイルを取り込むかどうか選択します。サブフォルダーのファイルは常に含まれることに注意してください。
コネクタは構成を検証した後、次を実行します。
指定されたソースからサポートされたファイルとユーザー権限を取り込みます。
:doc:`PARSE_DOCUMENTCortexの</user-guide/snowflake-cortex/parse-document>`関数AI を使用して、取り込んだファイルを解析し、チャンク化します。
解析されチャンク化されたデータを使用して、独自の AI アシスタントの RAG エンジンとして機能する Cortex Search Service を作成します。
組織の**IT 開発者** は、Slack、Teams、Webページのボット拡張機能など、選択したチャットインターフェースで、チャットボットを作成し、環境内で必要に応じてホストします。IT 開発者は、 Snowflake RESTAPIs スイートで利用可能なCortex Search RESTAPI エンドポイントを使用するために、Snowflakeでロール、権限、認証を構成します。
AI アシスタントが起動して実行されると、組織内の ビジネスユーザー は、アシスタントと対話して質問し、 SharePoint サイトからSnowflakeアカウントに取り込まれたファイルに基づく回答を表示できるようになります。すべての回答には、SharePoint サイトのソースドキュメントへのリンクである引用が含まれています。
AI アシスタントが組織の SharePoint サイトで指定されたアクセス制御に準拠できるようにします¶
このユースケースでの Snowflake Connector for SharePoint の操作は、大まかに4つのフェーズに分けられ、それぞれが特定のユーザーペルソナに関連付けられています。次のワークフローでは、これらのフェーズ、関連するユーザーのジャーニー、およびこのコネクタの仕組みについて説明します。
組織内の `AzureまたはOffice 365アカウント管理者<https://learn.microsoft.com/en-us/microsoft-365/admin/add-users/about-admin-roles>`_ は、 `ユーザーなしでアクセスを取得する<https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http>`_ の説明に従って、 OAuth 認証を有効にするように `Microsoft Graph<https://learn.microsoft.com/en-us/graph/overview>`_ を構成します。そして、必要な認証情報を組織のデータエンジニアまたはデータサイエンティストと共有します。
組織内の データエンジニアまたはデータサイエンティスト が、Snowflake MarketplaceからSnowflake用の SharePoint コネクタを自分のSnowflakeアカウントにインストールします。次に、次のようにコネクタを構成します。
ステップ1で取得した SharePointOAuth 認証情報（クライアント ID 、クライアントシークレット、およびテナント ID）を指定します。
SharePoint サイトの URL を指定します。通常、これは SharePoint サイト内の特定のサブサイトです。
すべてのフォルダーまたは SharePointURL の特定のフォルダーからファイルを取り込むかどうか選択します。サブフォルダーのファイルは常に含まれることに注意してください。
コネクタは構成を検証した後、次を実行します。
指定されたソースからサポートされたファイルとユーザー権限を取り込みます。
Cortex AI の PARSE_DOCUMENT 関数を使用して、取り込んだファイルを解析し、チャンク化します。
解析されチャンク化されたデータを使用して、独自の AI アシスタントの RAG エンジンとして機能するCortex Search Serviceを作成します。
組織の**IT 開発者** は、Slack、Teams、Webページのボット拡張機能など、選択したチャットインターフェースで、チャットボットを作成し、環境内で必要に応じてホストします。
Snowflake REST APIs スイートで利用可能なCortex Search REST API エンドポイントを使用するために、Snowflakeでロール、権限、認証を構成します。
AI アシスタントが Cortex Search REST API をクエリするときに、 SharePoint ユーザーのメール ID を含むフィルター（
filter.@contains.user_idsまたはfilter.@contains.user_emailsなど）を指定します。これにより、Cortex Searchからの応答は、指定されたビジネスユーザーが組織の SharePoint でアクセスできるドキュメントに制限されます。
AI アシスタントが起動して実行されると、組織内の ビジネスユーザー がアシスタントを操作して質問する場合、ステップ3（b）で指定したフィルターにより、アクセスできる SharePoint 内のファイルの情報のみが表示されます。すべての回答には、SharePoint サイトのソースドキュメントへのリンクである引用が含まれています。
制限事項¶
フォルダーの移動や名前の変更による変更は、増分取り込み中にはキャプチャされません。
コネクタはMicrosoft 365グループのみをサポートします。
コネクタはサポートされているファイルタイプのみを取り込み、それ以外は無視します。
リージョンの可用性¶
Snowflake Connector for SharePoint は Cortex Parseドキュメント および Cortex Search に依存します。
Snowflake Connector for SharePoint は現在、Cortex Parse Documentのリージョン別可用性 にリストされているリージョンで利用可能です。