Microsoft OneDrive
OneDriveコネクタを使用すると、DesignerのMicrosoft OneDriveクラウドストレージに接続できます。OneDriveは、データ入力ツールとデータ出力ツールでデータソースとして使用できます。
新しいOneDriveコネクタへのアップグレード
ワークフローでスタンドアロンのOneDrive入力ツールまたはOneDrive出力ツールを使用している場合、これらのツールは現在廃止されています。代わりに、データ入力ツールとデータ出力ツールでコネクタバージョン2.2.0以降を使用してください。ワークフロー移行ユーティリティを使用すると、既存のワークフローを更新できます。
必要条件
続行する前に、次の前提条件を満たしていることを確認してください。
要件 | 詳細 |
|---|---|
Designer | Designer 2026.1以降。 Designer 2025.2パッチ3以降。 Designer 2025.1パッチ5以降。 |
コネクタバージョン | Microsoft OneDriveバージョン2.2.0以降。Designerアドオンから利用できます。 |
Azureの権限 | Microsoft Azure APIアプリケーションのセットアップを参照してください。 |
DesignerでDCMを有効にする必要があります。[オプション] > [詳細設定] > [DCM]を選択して有効にします。 | |
ネットワークアクセス | OneDrive OnlineおよびMicrosoft OAuthエンドポイントへのアウトバウンドアクセス。 |
コネクタのインストール
アドオンを使用して、Designerから最新バージョンのOneDriveコネクタを直接インストールします。これは、Designerを終了したりAlteryx Marketplaceにアクセスしたりせずに、コネクタの参照、インストール、更新を実行できる推奨のインストール方法です。
コネクタをインストールするには次の手順に従います。
Designerで、[アドオン] > [Marketplaceアドオンの管理]に移動します。使用可能なコネクタのリストが表示されます。
[Microsoft OneDriveコネクタ]を選択し、[インストール]を選択します。Designerがパッケージをダウンロードしてインストールします。インストールを完了するために、Designerを再起動する必要がある場合があります。
インストールとセットアップの完了後、データ入力ツールとデータ出力ツールからOneDriveコネクタを使用できるようになります。
接続を設定します
Microsoft OneDriveに接続するには次の手順に従います。
データ入力ツールまたはデータ出力ツールをキャンバスにドラッグし、[データに接続]を選択します。
コネクタの設定で、[データ接続の作成または参照]を選択します。
以前にMicrosoft OneDrive接続を作成したことがある場合は、[最近]タブから接続を選択できます。
[+新規] を選択します。テクノロジーのリストから[Microsoft OneDrive]を選択します。
[接続名]と[データソース名]を入力します。
[資格情報]セクションで、認証方法を選択し、資格情報を入力します。詳細については、「認証方法」を参照してください。
[保存]を選択します。保存する前に接続をテストすることもできます。
[接続]を選択します。Microsoft OneDriveが認証を要求する場合があります。
[オプション]ウィンドウで読み取りまたは書き込み設定を選択します。オプションの詳細については、OneDriveからデータを読み取るまたはOneDriveにデータを書き込むを参照してください。
[確認]を選択して、ファイルへの接続を作成します。ワークフローの構築を続行できます。
ワークフローの移行
既存のワークフローで廃止されたOneDrive入力ツールまたはOneDrive出力ツールを使用している場合は、新しいコネクタを使用するように移行する必要があります。ワークフロー移行ユーティリティを使用すると、既存のワークフローを更新できます。
このユーティリティは、すべての変更のプレビューを表示し、ワークフローを中断することなく、廃止予定のツールインスタンスを新しいコネクタバージョンに置き換えます。
認証方法
Microsoft OneDriveは、3つの認証方法をサポートしています。以下の表をご確認いただき、ユースケースに適したものをご使用ください。
メソッド | 詳細 |
|---|---|
Azure AD-プライベート(ビルトインアプリ) |
|
Azure AD-プライベート(カスタムアプリ) |
|
サービスプリンシパル(アプリケーション) |
|
制限事項
Microsoft OneDriveコネクタには現在、次の制限事項があります。
Microsoftの内部で使用される[最近使ったもの]と[自分と共有]のGraph APIは廃止されており、データを返しません。これは、このコネクタとは独立したプラットフォームレベルの制限です。
そのため、[最近使ったもの]と[自分と共有]は参照もアクセスもできず、OneDriveのパスの範囲は[マイファイル]に制限されます。
パーティショニングはサポートされていません。
ワイルドカードを使用したデータの読み取り、または複数のファイルやフォルダーからのデータの読み取りはサポートされていませんが、マクロを使用して実行できます。
出力アクション[付加]はサポートされていません。[読み込み] > [ユニオン] > [上書き]を使用して、付加動作を再現します。
新しいファイルを作成するときに、保存先に同じ名前のファイルがすでに存在している場合、その操作によってファイルが上書きされることはありません。代わりに、新しいファイルの名前にタイムスタンプの接尾辞が付加され、両方のファイルが保持されます。
複数シートのXLSXファイルの読み取り、または名前やインデックスによるシートの選択はサポートされていません。
バージョン | 説明 |
v3.1.1 |
|
v3.1.0 |
|
v2.3.0 |
|
v2.2.0 |
|
v2.1.0 |
|
v2.0.2 |
|
v2.0.1 |
|
v2.0.0 |
|
v1.0.2 |
|
v1.0.1 |
|
v1.0.0 |
|
カスタムMicrosoft Azure APIアプリケーション
このツールのカスタムAPIアプリケーションを設定するには、ガイドを参照してください。
注記
OneDriveツールのバージョン2.2.0以降を含むワークフローで、AMP Engineが有効になっていることを確認します。詳細については、AMP Engineを参照してください。



