の設定 Snowflake Connector for SharePoint¶
注釈
Snowflake Connector for SharePoint は `コネクタ規約<https://www.snowflake.com/legal/snowflake-connector-terms/> に従います。
重要
用Snowflakeコネクタにご関心いただきありがとうございます。 SharePoint.現在、大幅に改善されたエクスペリエンスを提供する次世代のソリューションに焦点を当てています。したがって、このコネクタを一般公開ステータスに移行することは、現在の製品ロードマップにはありません。このコネクタはプレビュー機能として引き続き使用できますが、将来のバグ修正および改善のサポートは保証されないことに注意してください。新しいソリューションは として利用可能です 用Openflowコネクタ SharePoint および には、より優れたパフォーマンス、カスタマイズ性、強化された展開オプションが含まれます。
このトピックでは、Snowflake Connector for SharePoint を設定する手順について説明します。
前提条件¶
コネクタのインストールと構成を開始する前に、次を実行する必要があります。
次の権限を持つ Microsoft グラフ アプリケーションがあることを確認してください:
Sites.Selected: 指定したサイトのみにアクセスを制限します。
Files. SelectedOperations .Selected: 指定されたサイトのファイルのみにアクセスを制限します。
GroupMember .Read.All: SharePoint グループ権限の解決に使用します。
` ユーザーなしでアクセスを取得 <https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http#authentication-and-authorization-steps>`_ で説明されている方法で、OAuth を有効にするために、SharePoint を構成します。コネクタは次のMicrosoft グラフを使用します APIs データ取得元 SharePoint:
Snowflakeに取り込みたいファイルやフォルダーがあるMicrosoft 365 SharePoint サイトのサイト URL、およびAzureまたはOffice 365アカウント管理者からの認証情報を取得します。
Snowflake Connector for SharePoint のインストール¶
コネクタは、Snowflakeネイティブアプリケーションのインスタンスです。Snowflake Connector for SharePoint をインストールするには、次の操作を実行します。
ACCOUNTADMIN ロールを持つユーザーとしてSnowflakeにログインします。
Data Products » Marketplace に移動します。
Snowflake Connector for SharePoint を検索し、Get を選択します。
ダイアログボックスで、 Options を展開し、次の情報を入力します。
Application name に、コネクタアプリケーションの名前を入力します。
Warehouse used for installation で、コネクタのインストールに使用するウェアハウスを選択します。
注釈
これは、コネクタが SharePoint からのデータを同期するために使用するウェアハウスとは異なります。後のステップで、この目的のために別のウェアハウスを作成します。
Get を選択し、インストールプロセスを開始します。これが完了するまでに数分かかる場合があります。
コネクタが正常にインストールされたら、 Configure を選択して :ref:` の設定を続行するか、 <label-configure_sharepoint_connector>` または Done を選択して、ダイアログボックスを閉じてインストールを完了します。
オプション:Snowflake Connector for SharePoint の複数のインスタンスをインストールします¶
Snowflakeアカウントに Snowflake Connector for SharePoint の複数のインスタンスをインストールできます。追加のインスタンスをインストールするには、次を実行します:
Snowflake Marketplaceに移動し、Snowflake Connector for SharePoint を選択します。アプリケーションの詳細ページが表示されます。
Add instance をクリックします。インストールダイアログが表示されます。
インスタンス名を指定し、インストール中に使用するウェアハウスを選択します。
Get を選択し、インストールプロセスを開始します。
注釈
コネクタインスタンスの追加には数分かかる場合があります。インストールプロセスが完了すると、メールで通知が届きます。
インジェストされたデータの破損を避けるため、コネクタ構成中は、常に他のすべてのネイティブアプリケーションとは異なるデータベーススキーマを使用します。
Snowflake Connector for SharePoint の構成¶
各コネクタアプリケーションインスタンスは、関連するSharepointインスタンスと通信するように構成する必要があります。:ref:`インストールプロセス <label-install_sharepoint_connector>`完了後、次のステップに進みます。
前提条件がすべて完了していることを確認します。 詳細については、 前提条件 をご参照ください。
必要に応じて、次のように構成ウィザードを開きます。
ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。
ナビゲーションメニューで Data Products » Apps を選択します。
Snowflake Connector for SharePoint を検索して選択します。
構成¶
Configure ウィザードのステップで、次のフィールドに情報を入力します:
注釈
デフォルトでは、フィールドはコネクタの構成時に作成されるオブジェクトの名前に設定されます。Snowflakeは、これらのフィールドに新しいオブジェクトを使用することをお勧めします。ただし、必要な場合、既存のオブジェクトの名前を指定できます。例: コネクタを再インストールする場合。
フィールド
説明
Warehouse for Ingestion Data
コネクタ専用の新しい仮想ウェアハウスの識別子。このウェアハウスは、データの取り込みとドキュメント処理のタスクを計算するために使用されます。
アカウントに一意の名前を指定します。ウェアハウスの名前は、有効な :doc:`オブジェクト識別子</sql-reference/identifiers-syntax> である必要があります。
または、既存のウェアハウスを選択することもできます。
注釈
コネクタの初期作成時に使用するウェアハウスは指定しないでください。
Warehouse for Cortex Search:
新しい専用Cortex検索仮想ウェアハウスの識別子。このウェアハウスは、Cortex Searchクエリの処理と提供に使用されます。
アカウントに一意の名前を指定します。ウェアハウスの名前は、有効な :doc:`オブジェクト識別子</sql-reference/identifiers-syntax> である必要があります。
注釈
コネクタのインストールの開始時に選択したものと同じウェアハウスを指定しないでください。構成プロセスにより、指定された名前で新しい X-Small ウェアハウスが作成されます。
Role for Cortex Search
コネクタ用の新しいカスタムロールの識別子。アカウントに一意の名前を指定します。ロールの名前は、有効な :doc:`オブジェクト識別子</sql-reference/identifiers-syntax> である必要があります。
ロールを付与されたユーザーは、そのアカウントを使用して、アプリケーションによってインジェストされたデータについてCortex RESTAPI にクエリできます。 デフォルトでは、コネクタのインストールに使用したアカウントのみがCortex をクエリする権限を持っています。
Configure をクリックを続行します。
Sharepointへの認証と接続¶
重要
ブラウザでポップアップが有効になっていることを確認します。
Authentication ウィザードのステップで、次の情報と認証情報を入力し、 OAuth2 認証を完了して SharePoint に接続します。
この情報については、AzureまたはOffice 365のアカウント管理者にお問い合わせください。
フィールド
説明
SharePoint site URL
URL またはコネクタがコンテンツを取り込む共有ポイントサイト。
トップレベルサイトの場合は、ドメイン名のみを使用します。例:
sitename.sharepoint.com``サブサイトの場合は、サイトパスを含むドメイン名を使用します。例:``sitename.sharepoint.com/sites/SubSite
Client ID
クライアント ID を入力してください。クライアント の詳細 ID とMicrosoft Entraでそれを見つける方法については、をご参照ください。 アプリケーション ID (クライアント ID).
Client secret
クライアントシークレットを入力してください。クライアントシークレットの詳細と、Microsoft Entraでそれを見つける方法については、をご参照ください。 証明書およびシークレット.
Tenant ID
テナント ID を入力してください。テナントの詳細 ID とMicrosoft Entraでそれを見つける方法については、をご参照ください。 `Microsoft 365テナントを見つける ID<https://learn.microsoft.com/en-us/sharepoint/find-your-office-365-tenant-id>`_.
Next をクリックして接続プロセスを開始します。完了するまでに数分かかる場合があります。
ソースの検証¶
ウィザードの Validate source ステップでは、次を実行します。
ファイルをフェッチするソースを選択します。
All folders を選択すると、 Sharepointへの認証と接続 で指定した認証情報を介してアクセスできるすべてのフォルダーからファイルをフェッチします。
label-connect_to_sharepoint`で指定した認証情報を介してアクセス可能な特定のフォルダーからファイルをフェッチする場合は、:ui:`Specific folder を選択してください。
注釈
このパスは、共有ドキュメントフォルダーからの相対パスです。たとえば、フォルダー
Shared%20Documents/user_manuals/cars
からファイルを取り込むには、user_manuals/cars
を入力します。
注釈
フェッチファイルソースを後で変更するには、コネクタを再インストールする必要があります。
Validate をクリックしてソースの検証プロセスを開始します。これには数分かかる場合があります。
コネクタが正常に構成されたら、Ingest files をクリックしてデータインジェスチョンを開始します。
次のステップ¶
コネクタの設定ができたら、 Snowflake Connector for SharePoint でCortex Search Serviceをクエリする に進みます。