SharePoint Online

Foundry に SharePoint ライブラリからファイルをインポートするために SharePoint Online に接続します。

サポートされている機能

データモデル

コネクタは任意のタイプのファイルを Foundry データセットに転送できます。ファイル形式は保持され、転送中または転送後にスキーマは適用されません。出力データセットに必要なスキーマを適用するか、下流変換を記述する ことでデータにアクセスします。

パフォーマンスと制限

転送可能なファイルのサイズには制限がありません。しかし、ネットワークの問題により、大規模な転送が失敗する可能性があります。特に、実行に 2 日以上かかる直接のクラウド同期は中断されます。ネットワークの問題を避けるため、ファイルサイズを小さくし、同期の実行ごとに取り込むファイル数を制限することをお勧めします。同期は頻繁に実行するようにスケジュールすることができます。

設定

1. Data Connection アプリケーションを開き、画面の右上隅にある + New Source を選択します。
2. 利用可能なコネクタタイプから SharePoint Online を選択します。
3. インターネット経由の 直接接続 を使用するか、または 中間エージェント経由 の接続を選択します。
4. 以下のセクションの情報を使用して、コネクタの設定を続けるための追加の設定プロンプトに従います。

Foundry での コネクタの設定 について詳しく学ぶ。

認証

以下の初期手順に従って Azure アプリケーションの資格情報にアクセスします：

1. Microsoft のドキュメント (外部) の指示に従って Azure にアプリケーション登録を作成します。
   • ステップ 5 で、Accounts in this organizational directory only を選択し、Redirect URL (optional) をスキップします。
2. 登録が完了したら、クライアント ID とテナント ID をメモします。

次に、2つの利用可能な認証方法から選択します：

• クライアント資格情報： 全ての SharePoint サイトに対して広範なアクセスが必要な場合に推奨。
• ユーザー名/パスワード： 1つまたは数個の SharePoint サイトへのアクセスを制限する場合に推奨。

クライアント資格情報

Microsoft Entra 管理センターで以下の手順を完了します：

1. 左側のサイドバーで API Permissions に移動します。

2. Add a Permission を選択します。

3. Microsoft Graph を選択します。

4. Application Permissions を選択します。

   • アプリケーションが 全ての SharePoint サイトを読みたい場合は Sites.Read.All を追加します。
     • エクスポートタスクを設定する予定の場合は、代わりに Sites.ReadWrite.All を使用します。
   • アプリケーションが 選択した SharePoint サイト を読みたい場合は Sites.Selected を追加します。

5. Entra 管理者である場合は、Grant admin consent for [tenant] を選択します。

6. 上記で Sites.Selected を追加した場合は、特定のサイトにアプリケーションを追加します (外部)。

   • "roles" 配列パラメーターの利用可能なオプションは "write" および/または "read" です。 "read" オプションは SharePoint サイトからファイルを取り込むのに十分です。
   • 適切な認証で POST を簡単に送信するには、Graph Explorer を使用します。
   • https://graph.microsoft.com/v1.0/sites/[tenantName]:/sites/[siteName] (例：https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/mySite) に GET を送信することで、サイトに関するメタデータを受け取ることができます。このリクエストは、サイトコレクションのホスト名、サイトコレクションの一意の ID、およびサイトの一意の ID の複合値である ID を返します。中間の値は、権限 POST を実行するために必要な siteId です。

7. クライアントシークレットを生成します。

Data Connection で以下のソース設定を設定します：

ユーザー名/パスワード

ユーザー名/パスワードフローでは、Microsoft 365 にサインインできるユーザーアカウントを作成します。Graph API は、ユーザー名/パスワード認証方法で二要素認証をサポートしていません。そのため、32文字以上のランダムに生成されたパスワードを作成することを強く推奨します。

Entra 管理センターで以下の手順を完了します：

1. 左側のサイドバーで API Permissions に移動します。
2. Add a Permission を選択します。
3. Microsoft Graph を選択します。
4. Delegated Permissions を選択します。
5. Sites.Read.All の権限を追加します。
   • エクスポートタスクを設定する予定の場合は、代わりに Sites.ReadWrite.All を使用します。
6. Azure 管理者である場合は、Grant admin consent for [tenant] を選択します。
7. 左側のサイドバーで Authentication に移動します。
8. Allow public client flows を Yes に変更します。
9. 32文字以上のランダムに生成されたパスワードで Microsoft Entra ID にユーザーを作成します。
10. そのユーザーを読み取りまたは書き込みを行いたい SharePoint サイトに追加します。

Data Connection で以下のソース設定を設定します：

ネットワーキング

SharePoint Online コネクタは、ポート 443 で以下のドメインにネットワークアクセスが必要です：

• login.microsoftonline.com
• graph.microsoft.com
• あなたの SharePoint URL。例：contoso.sharepoint.com

GovCloud Sharepoint インスタンスを使用している場合は、代わりにポート 443 で以下のドメインを使用します：

• login.microsoftonline.us
• graph.microsoft.us
• あなたの SharePoint URL。例：contoso.sharepoint.us

設定オプション

SharePoint Online コネクタには以下の設定オプションが利用可能です：

Sharepoint Online からのデータ同期

SharePoint Online コネクタは ファイルベースの同期インターフェース を使用します。

SharePoint Online へのデータエクスポート

SharePoint サイトへのエクスポートを行うには、まず SharePoint Online コネクタの エクスポートを有効にする します。次に、新しいエクスポートを作成する。

エクスポート設定オプション