データパイプラインソースとしてのOneDriveの設定 ​

OneDriveをデータパイプラインソースとして設定し、レコードを抽出して同期先に同期します。

このガイドでは、OneDriveフォルダに保存されている.csvファイルと.parquetファイルを扱うためのコネクション設定、パイプライン設定、および主な動作を確認できます。

サポートされている機能 ​

OneDriveをデータパイプラインソースとして使用する場合、以下の機能がサポートされます。

• ファイル形式のサポート：OneDriveフォルダ内の.csvファイルと.parquetファイルからデータを抽出して同期します。

• 完全同期と増分同期：パイプラインの開始時に完全同期を実行し、その後の各実行では増分同期を実行して、前回の実行以降に作成または変更されたファイルを取得します。

• ドライブの選択：共有ドライブやSharePointサイトのドキュメントライブラリを含め、同期元となる特定のOneDriveドライブを選択します。

• フィールド単位の選択：抽出して同期先に複製するフィールドを選択します。

• フィールドレベルのデータ保護：データがデスティネーションに到達する前に、機密フィールドをハッシュ化するか、そのままレプリケートします。

前提条件 ​

OneDriveをデータパイプラインソースとして接続するには、以下が必要です。

• Microsoft OneDriveアカウント：個人用、ビジネス用、または特定のテナントに紐付けられたアカウント
• 選択した認証方法の認証情報:
  • 認可コードグラント：Azureポータルでアプリを登録し、必要なアクセス許可を割り当てます。設定手順については、OneDriveへの接続を参照してください。
  • クライアント資格情報グラント：Azureポータルでテナント固有のアプリを登録し、クライアントシークレットを生成して、テナントID、クライアントID、およびユーザーIDを取得します。この方法は、テナント固有のアカウントでのみ使用できます。設定手順については、OneDriveへの接続を参照してください。

サポートされるコネクションタイプ ​

OneDriveデータパイプラインは、以下の認証方法をサポートしています。

• 認可コードグラント（OAuth 2.0）：Microsoftの個人用、ビジネス用、またはテナント固有のアカウントでサインインします。設定手順については、OneDriveへの接続を参照してください。
• クライアント資格情報グラント（OAuth 2.0）：対話型のユーザーサインインを行わずに、テナント固有のアプリのクライアントIDとクライアントシークレットを使用して認証します。この方法は、テナント固有のアカウントでのみサポートされています。

OneDriveへの接続 ​

OneDriveコネクターは、次の認証タイプをサポートしています:

• 認可コードグラント認証（OAuth 2.0）
• クライアント認証情報ベースの認証（OAuth 2.0）

認可コード付与認証（OAuth 2.0） ​

テナント固有のアカウントタイプではTenant ID/Domain値を使用します。

最小スコープとデフォルトスコープ ​

OneDriveコネクタは、デフォルトで次のスコープをリクエストします。これらのスコープは、すべてのトリガーとアクションをサポートします。 Azureポータルで、これらを委任されたアクセス許可として割り当てる必要があります：

• Files.ReadWrite
• Group.Read.All
• Files.Read
• offline_access

認可コードグラント認証を使用してOneDriveへのコネクションを確立するには、次の最小スコープを追加する必要があります：

• Files.Read
• offline_access

認可コードグラント認証用のOneDriveセットアップ ​

認可コードグラント認証用にOneDriveを設定するには、次の手順を実行します：

• Azure portalでWorkatoアプリを登録
• アプリに権限を割り当てる
• Azureポータルからディレクトリ（テナント）IDを取得する

Azure portalでWorkatoアプリを登録 ​

https://www.workato.com/oauth/callback

アプリに権限を割り当てる ​

Azureポータルからディレクトリ（テナント）IDを取得する ​

認可コードグラント認証でOneDriveに接続 ​

クライアント資格情報ベースの認証（OAuth 2.0） ​

この認証タイプには、次の値が必要です：

• Tenant ID/Domain
• ユーザーID
• Client ID
• クライアントシークレット

最小スコープとデフォルトスコープ ​

クライアント資格情報ベースのコネクションには、次のスコープを推奨します。これらのスコープは、すべてのトリガーとアクションをサポートします。 Azureポータルで、これらをアプリケーションのアクセス許可として割り当てる必要があります：

• Files.Read.All
• Files.ReadWrite.All
• Group.Read.All
• Sites.ReadWrite.All

クライアント資格情報ベースの認証でOneDriveへのコネクションを確立するには、次の最小スコープを追加する必要があります：

• Files.Read.All

クライアント資格情報ベースの認証用のOneDriveセットアップ ​

クライアント資格情報ベースの認証用にOneDriveを設定するには、次の手順を実行します：

• Azure portalでWorkatoアプリを登録する
• アプリに権限を割り当てる
• クライアントシークレットを生成する
• Azureポータルからアプリケーション（クライアント）ID、オブジェクトID、ディレクトリ（テナント）IDを取得する
• AzureポータルからユーザーIDを取得する

Azure portalでWorkatoアプリを登録 ​

https://www.workato.com/oauth/callback

アプリに権限を割り当てる ​

クライアントシークレットを生成する ​

Azureポータルからアプリケーション（クライアント）ID、オブジェクトID、ディレクトリ（テナント）IDを取得する ​

AzureポータルからユーザーIDを取得する ​

クライアント資格情報ベースの認証でOneDriveに接続 ​

Microsoft Entra IDをOneDriveコネクターに接続 ​

パイプラインの設定 ​

以下の手順を実行して、OneDriveをデータパイプラインソースとして設定します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

OneDriveには固定のオブジェクトカタログがありません。代わりに、追加したフォルダとファイル名パターンの各設定がオブジェクトとなり、同期先の個別のテーブルとして同期されます。

詳細については、同期モードと削除の追跡を参照してください。

同期モード ​

OneDriveデータパイプラインは完全同期を実行し、その後の各実行では増分同期を実行します。この順序は変更できません。

フル同期 ​

完全同期では、設定されたフォルダのパス、ファイルタイプ、およびファイル名パターンに一致するすべてのファイルを一覧表示し、一致する各ファイルからすべての行を抽出します。この完全同期は、パイプラインの開始時に一度だけ実行されます。以降の各実行は増分同期です。

増分同期 ​

増分同期は行単位ではなく、ファイル単位で行われます。各実行では、一致するファイルを一覧表示し、最後に記録された変更時刻より後に作成または変更されたファイルのみを処理します。 OneDriveはCSVファイルまたはParquetファイル内の行単位の変更追跡を提供しないため、変更されたファイルは、行ごとに差分を比較するのではなく、全体が再処理されます。

削除追跡 ​

OneDriveは削除の追跡をサポートしていません。選択したマージ方法にかかわらず、ソースファイルが削除されても、Workatoは同期先の行を削除したり、削除済みとしてマークしたりしません。この動作が必要な場合は、ソースファイルに削除を追跡する列を含めてください。

スキーマとデータ型の処理 ​

OneDriveデータパイプラインは、選択されたCSVファイルまたはParquetファイルからスキーマを推論します。

• CSVファイル：Workatoはファイルをサンプリングして、列名と型を推論します。曖昧な値やサポートされていない値は、文字列のまま保持されます。
• Parquetファイル：Workatoは、埋め込まれたParquetスキーマをファイルから直接読み取ります。ネストされた構造と繰り返しフィールドは、共通のParquetリーダーの仕様に従って保持され、必要に応じてネストされた構造がJSON文字列としてシリアル化されます。

正確なスキーママッピングを確保するため、同じオブジェクト設定に一致するすべてのファイルは、同じ列構造とデータ形式を維持する必要があります。

合成列 ​

Workatoは、各同期先テーブルに以下の合成列を追加します。

マージ方法と主キーの選択方法については、パイプラインの設定の手順を参照してください。

機密データの処理 ​

OneDriveファイルには、個人を特定できる情報（PII）やその他の機密性の高い内容など、任意の顧客データが含まれる可能性があります。ファイルの列は、固定のソースAPIフィールドではなく顧客が定義するため、OneDriveデータパイプラインには機密フィールドの固定リストがありません。

パイプライン設定中にフィールドレベルのデータ保護でHashオプションを使用し、PIIが宛先に到達する前に保護します。詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

OneDriveをデータパイプラインソースとして使用する場合、以下の制限が適用されます。

サポートされるファイル形式 ​

OneDriveデータパイプラインは、.csvファイルと.parquetファイルのみをサポートします。 Excel、JSON、XML、PDF、画像、およびその他のバイナリファイルなど、他の形式はサポートされていません。

フォルダの走査 ​

OneDriveデータパイプラインは、設定されたフォルダの直下にあるファイルのみを取得します。ネストされたサブフォルダ内のファイルは取得も同期もされません。

最大ファイルサイズ ​

各ファイルのサイズは10 GB以下である必要があります。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。