CSV コネクタ

  • [アーティクル]

CSV Graph コネクタを使用すると、organizationは SharePoint ライブラリとAzure Data Lake Storage (ADLS) に格納されている CSV ファイルからコンテンツを取り込みます。 これらのソースからコネクタとインデックス コンテンツを構成すると、エンド ユーザーは Microsoft Search で CSV ファイルを見つけることができます。

注:

一般的 な Graph コネクタのセットアップ 手順については、Graph コネクタのセットアップに関する記事を参照してください。

この記事は、CSV コネクタを構成、実行、監視するすべてのユーザーを対象とします。 一般的なセットアップ プロセスを補完し、このコネクタにのみ適用される手順を示します。

使用を開始する前に

CSV ヘッダーに空白がないことを確認します。 SharePoint データ ソースの場合は、Oauth 構成で SharePoint アプリを作成する必要があります。 ADLS データ ソースの場合は、ADLS ストレージ アカウントを作成する必要があります。

Oauth 構成で SharePoint アプリを作成する

インデックスを作成する .csv ファイルが SharePoint ドキュメント ライブラリにアップロードされていることを確認します。 既存の SharePoint サイトを使用することも、新しいサイトを作成することもできます。

SharePoint アプリを作成する

  1. https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspxに移動します。
  2. [クライアント ID] フィールドと [クライアント シークレット] フィールドで、[ 生成] を選択します。
  3. [タイトル] にアプリ名を入力します。
  4. [アプリ ドメイン] フィールドに「」と入力します www.gcs.com。
  5. [リダイレクト URL] フィールドに「」と入力します https://www.gcs.com。
  6. [作成] を選択します。
  7. クライアント ID やクライアント シークレットなど、アプリ構成情報をコピーします。 CSV コネクタを設定するときに必要になります。

アプリのアクセス許可を有効にして CustomAppAuthentication を許可する

PowerShell (SharePoint Online 管理シェル) で、これらのコマンドを管理モードで実行します。 コネクタとorganization名を構成する管理者のメール アドレスを使用します。 パスワードのポップアップが表示されたら、管理者は自分のパスワードを入力する必要があります。

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

注:

PowerShell 7 を使用している場合は、最初にこのコマンドを使用します Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

注:

多要素認証を使用している場合は、 を使用します Connect-SPOService -Url https://$orgName-admin.sharepoint.com。

アプリの構成を完了する

  1. https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspxに移動します。
  2. [アプリ ID] フィールドに、SharePoint アプリのクライアント ID を貼り付けて、[参照] を選択 します。
  3. [アクセス許可要求 XML] フィールドに、このコードを貼り付け、[ 作成] を選択します。
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. [信頼する] を選択します。

ADLS ストレージ アカウントを作成する

詳細なガイダンスについては、「 ストレージ アカウントの作成」を参照してください。 ファイル ストレージ機能を許可するには、[詳細設定] タブで、[ 階層型名前空間を有効にする ] と [ このサイトのコンテナーの作成] を選択します。

CSV コネクタを設定するときは、プライマリ ストレージ 接続文字列を指定する必要があります。 これを見つけるには、作成したストレージ アカウントを開き、[ アクセス キー] を選択します。 [キーの表示] を選択し、Key1 の接続文字列をコピーします。

手順 1: Microsoft 365 管理センターで Graph コネクタを追加する

CSV コネクタの追加

一般的な セットアップ手順に従います。

手順 2: エクスペリエンスを選択する

現在、CSV コネクタは検索エクスペリエンスのみをサポートしています。

Microsoft Search エクスペリエンスが選択された CSV コネクタ。

手順 3: 接続に名前を付けます

一般的な セットアップ手順に従います。

手順 4: 接続設定を構成する

データ ソースの設定は、SharePoint と ADLS で異なります。

注:

csv ファイルに、ヘッダー行に書式やスペース (' ') が存在しないことを確認します。

SharePoint ソースの場合

  1. [データ ソース] 設定で、データソースとして [SharePoint ] を選択します。
  2. SharePoint サイトで、サイト URL ( など) をhttps://Org-Name.sharepoint.com/Site-Name入力します。
  3. [ ドキュメント ライブラリ] に、.csv ファイルが格納されているライブラリの名前を入力します。
  4. [ 認証の種類] で、[ Oauth2.0(クライアント資格情報)] を選択します。
  5. SharePoint アプリの作成時にコピーしたクライアント ID とクライアント シークレットを入力します。
  6. [ テスト接続] を選択します。 [接続が成功しました] というメッセージが表示されます。

SharePoint サイトのデータ ソース設定を含む CSV コネクタ。

ファイル レベルでアクセスを制御するには、「ユーザーまたはグループMicrosoft Entra」と入力します。

ユーザーとグループを含むアクセス制御リスト。

ADLS ソースの場合

  1. [データ ソース] 設定で、データソースとして [Azure Data Lake Storage(ADLS)] を選択します。
  2. [プライマリ ストレージ 接続文字列] に、コピーした接続文字列を入力します。
  3. [コンテナー名] と [ファイル名] を入力します。
  4. [ テスト接続] を選択します。 [接続が成功しました] というメッセージが表示されます。

Azure Data Lake Storage ソースのデータ ソース設定を含む CSV コネクタ。

注:

データソースに同じヘッダーを持つ複数の .csv ファイルが含まれている場合は、[ すべての CSV ファイルを場所に含める] を選択します。

ファイル レベルでアクセスを制御するには、「ユーザーまたはグループMicrosoft Entra」と入力します。

ユーザーとグループを含むアクセス制御リスト。

手順 5: 複数項目区切り記号 (省略可能)

ソース列で複数の値を使用できる場合は、複数項目の区切り記号であるセミコロン (;)など) を入力します。

手順 6: 解析されたプロパティの設定

このページでは、.csv ファイルの最初の行が [ソース プロパティ] として返されます。 Datatype を変更するには、[ 一意識別子 ] ボックスの一覧で少なくとも 1 つのオプションを選択します。

項目レベルでアクセスを制御するには、[許可されたユーザー] と [許可されたグループ] にマップされている列を選択します。 .csv ファイルには、AllowedUsers と AllowedGroups の 2 つの列を含める必要があります。 各行には、Microsoft Entra ID が含まれている必要があります。

項目レベルのアクセス制御設定。

注:

CSV コネクタは、ファイルレベルまたは項目レベルのアクセス制御をサポートします。 両方が有効になっている場合は、ファイル レベルのアクセス制御のみが適用されます。

手順 7: プロパティ ラベルを割り当てる

一般的な セットアップ手順に従います。

注:

IconURL ラベルは既定で設定され、マッピングを変更することはできません。

手順 8: スキーマを管理する

一般的な セットアップ手順に従います。

手順 9: 検索アクセス許可を管理する

  • ファイルレベルまたはアイテムレベルのアクセス制御の場合は、[ このデータ ソースへのアクセス権を持つユーザーのみ] を選択します。
  • [全員] を選択すると、organizationのすべてのユーザーがこのデータ ソースの検索結果を表示できます。

このデータ ソースへのアクセス権を持つユーザーのみが選択されている検索アクセス許可の設定。

手順 10: 更新設定を選択する

一般的な セットアップ手順に従います。

手順 11: 接続を確認する

一般的な セットアップ手順に従います。

制限事項

CSV コネクタの既知の制限事項を次に示します。

  • プロファイル エンリッチメントのシナリオは、現時点ではサポートされていません。