方法: 大文字と小文字を区別しない (CI) 照合順序を使用してウェアハウスを作成する

適用対象:✅Microsoft Fabric のウェアハウス

既定では、すべての Fabric ウェアハウスは、大文字と小文字を区別する (CS) 照合順序 Latin1_General_100_BIN2_UTF8 で構成されます。 また、大文字と小文字を区別しない (CI) 照合順序 - Latin1_General_100_CI_AS_KS_WS_SC_UTF8 を使用したウェアハウスを作成することもできます。

現時点では、大文字と小文字を区別しないデータ ウェアハウスを作成するために使用できる唯一の方法は、REST API を使用することです。 この記事では、REST API を使用して、大文字と小文字を区別しない照合順序を使用してウェアハウスを作成する方法のステップバイステップ ガイドを提供しています。 また、Visual Studio Code と REST クライアント拡張機能を使用してプロセスを容易にする方法についても説明します。

前提条件

• アクティブな容量または試用版の容量を持つ Fabric ワークスペース。
• Visual Studio Code をダウンロードしてインストールし、アプリケーションをダウンロードしてインストールします。
• REST クライアント - Visual Studio Marketplace をインストールします。

API エンドポイント

REST API を使用してウェアハウスを作成するには、API エンドポイントを使用します: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

ウェアハウスを作成するための JSON 要求本文のサンプルを次に示します。

{ 
  "type": "Warehouse", 
  "displayName": "CaseInsensitiveAPIDemo", 
  "description": "New warehouse with case-insensitive collation", 
  "creationPayload": { 
    "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
  } 
}

Visual Studio Code を使用して REST API を呼び出す

Visual Studio Code (VS Code) と REST Client 拡張機能を使用して、大文字と小文字を区別しない照合順序を使用した新しいウェアハウスを簡単に作成できます。 次のステップを実行します。

1. .http 拡張機能を使用した VS Code で新しいテキスト ファイルを作成します。

2. ファイル本文に要求の詳細を入力します。 ヘッダーと本文の間には、"Authorization" 行の後に空白スペースが配置されている必要があることに注意してください。

     POST https://api.fabric.microsoft.com/v1/workspaces/<workspaceID>/items HTTP/1.1
     Content-Type: application/json
     Authorization: Bearer <bearer token>
   
   { 
      "type": "Warehouse", 
      "displayName": "<Warehouse name here>", 
      "description": "<Warehouse description here>", 
      "creationPayload": { 
        "defaultCollation": "Latin1_General_100_CI_AS_KS_WS_SC_UTF8" 
      } 
    }
   

3. プレースホルダー値を次のように置き換えます。

   • <workspaceID>: /groups/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してワークスペース GUID を検索します。

   • <bearer token>: 次の手順に従ってこれを取得します。

     1. ブラウザー (Microsoft Edge または Google Chrome) で Microsoft Fabric ワークスペースを開きます。
     2. F12 キーを押して開発者ツールを開きます。
     3. [コンソール] タブを選択します。必要に応じて、[簡易ビューの展開] を選択して、コンソール プロンプト > を表示します。
     4. コマンド copy(powerBIAccessToken) を入力して、Enter キーを押します。 コンソールが未定義に応答している間、ベアラー トークンがクリップボードにコピーされます。
     5. <bearer token> の代わりに貼り付けます。

     手記

     一部のシナリオでは、ページに "copy" という名前の要素 ID がある場合、エラー uncaught TypeError: copy is not a function で copy(powerBIAccessToken) が失敗することがあります。 このような場合は、"copy" 関数を使用する前に、次のコマンドを使用して要素 ID を手動で削除します:document.querySelector('#copy').remove()。

   • <Warehouse name here>: 目的のウェアハウス名を入力します。

   • <Warehouse description here>: 目的のウェアハウスの説明を入力します。

4. VS Code エディターで POST コマンドに表示される [要求を送信する] リンクを選択します。

5. POST 要求に関する追加の詳細と共に、状態コード 202 Accepted を含む応答を受け取る必要があります。

6. Fabric ポータルで新しく作成されたウェアハウスに移動します。

7. クエリ エディターで次の T-SQL ステートメントを実行して、ウェアハウスの照合順序が上記の JSON で指定したものと一致することを確認します。

   SELECT name, collation_name FROM sys.databases;
   

関連するコンテンツ

• Microsoft Fabric でウェアハウスを作成する
• Microsoft Fabric のデータ ウェアハウスのテーブル
• Microsoft Fabric のデータ型