注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
Microsoft OneDrive
Microsoft OneDrive コネクターは、Microsoft OneDrive 用の Palantir 提供のドライバーです。
新しい Microsoft OneDrive ソースを作成するには、Palantir 提供のドライバーの標準セットアップフローに沿って進め、以下のセクションで Microsoft OneDrive 固有の設定とネットワーク設定を行います。プロパティの完全なリファレンスについては、Microsoft OneDrive ドライバーの公式ドキュメント ↗を参照してください。
Microsoft OneDrive コネクターは開発のベータ版段階にあり、お使いのエンロールメントでは利用できない場合があります。開発が活発に行われている間は、機能が変更される場合があります。
サポートされる機能
| 機能 | ステータス |
|---|---|
| 探索 | 🟡 ベータ版 |
| バッチ同期 | 🟡 ベータ版 |
| インクリメンタル（差分連携） | 🟡 ベータ版 |
| OAuth 2.0 認証 | 🟡 ベータ版 |
設定
以下のプロパティは必須または推奨です。
| プロパティ | 必須かどうか | 説明 | デフォルト |
|---|---|---|---|
AuthScheme ↗ | 推奨 | Microsoft OneDrive に接続するときに使用する認証の種類を指定します。このプロパティを空白のままにすると、デフォルトの認証が使用されます。 | AzureServicePrincipal |
AzureTenant ↗ | 推奨 | データへのアクセスに使用する Microsoft OneDrive テナントを、名前（例：contoso.onmicrosoft.com）または ID で識別します。（条件付き）。 | — |
InitiateOAuth ↗ | 推奨 | OAuth アクセストークンを取得または更新するプロセスを指定します。このトークンは、認証および承認されたユーザーが作業している間、ユーザーのアクセスを維持します。 | GETANDREFRESH |
OAuthClientId ↗ | 推奨 | カスタム OAuth アプリケーションの作成時に割り当てられたクライアントIDを指定します。（コンシューマー鍵とも呼ばれます。）この ID は、カスタムアプリケーションを OAuth 認可サーバーに登録します。 | — |
OAuthClientSecret ↗ | 推奨 | カスタム OAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。（コンシューマーシークレットとも呼ばれます。）このシークレットは、カスタムアプリケーションを OAuth 認可サーバーに登録します。 | — |
ネットワーク
以下のテーブルは、ソースの実行に必要なアクセス先ドメインを示しています。
各ドメインに対応するエグレスポリシーを追加します。ソースがオンプレミスでホストされ、Foundry から直接アクセスできない場合は、代わりに Agent プロキシエグレスポリシーを使用します。Agent ホスト自体も、記載されているドメインにアクセスできる必要があります。詳細については、Agent をプロキシとして使用するを参照してください。
| ドメイン | 必須条件 |
|---|---|
| graph.microsoft.com | AzureEnvironment=GLOBAL（デフォルト）の場合 |
| login.microsoftonline.com | AuthScheme=AzureAD（デフォルト）、AzureServicePrincipal、AzureServicePrincipalCert のいずれかで、かつ AzureEnvironment=GLOBAL の場合 |
| microsoftgraph.chinacloudapi.cn | AzureEnvironment=CHINA の場合 |
| login.chinacloudapi.cn | AuthScheme=AzureAD（デフォルト）、AzureServicePrincipal、AzureServicePrincipalCert のいずれかで、かつ AzureEnvironment=CHINA の場合 |
| graph.microsoft.us | AzureEnvironment=USGOVT の場合 |
| login.microsoftonline.us | AuthScheme=AzureAD（デフォルト）、AzureServicePrincipal、AzureServicePrincipalCert のいずれかで、かつ AzureEnvironment=USGOVT または USGOVTDOD の場合 |
| dod-graph.microsoft.us | AzureEnvironment=USGOVTDOD の場合 |
OAuth 2.0 認証
このコネクターは OAuth 2.0 認証をサポートしています。Palantir 提供のドライバーに関する OAuth 2.0 ガイダンスに従って、接続を設定し、承認します。
ファイルを抽出する
DownloadFile ↗ ストアドプロシージャを実行すると、Microsoft OneDrive からファイルを抽出できます。
ファイルを抽出するには、同期定義に以下の SQL クエリを追加します。
Copied!1EXECUTE DownloadFile ResourceId = '1234'
これにより、ファイルの内容が Base64 エンコードされた文字列の列に格納された出力データセットが生成されます。この内容は、下流のデータ変換でバイナリにデコードする必要があります。
