次の方法で共有

データ ウェアハウスの照合順序

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

Fabric Data Warehouse では、大文字と小文字を区別する照合順序と大文字と小文字を区別しない照合順序の両方がサポートされています。 サポートされているウェアハウスの照合順序は次のとおりです。

  • Latin1_General_100_BIN2_UTF8 (既定値)(大文字と小文字が区別されます)
  • Latin1_General_100_CI_AS_KS_WS_SC_UTF8 (大文字と小文字は区別されません)

新しいウェアハウスとすべての SQL 分析エンドポイントは、ワークスペースの Data Warehouse の既定の照合順序設定に基づいて構成されます。既定では、大文字と小文字が区別される照合順序 Latin1_General_100_BIN2_UTF8 が使用されます。

ワークスペース レベルの照合順序を変更しても、既存のウェアハウスや SQL 分析エンドポイントには影響しません。 クロスウェアハウス クエリでは、照合順序が異なるアイテム間でエラーや予期しないクエリ結果が発生する可能性があります。

大文字小文字を区別しない照合順序でデータウェアハウスを作成するには:

重要

ウェアハウスまたは SQL 分析エンドポイントが作成されると、照合順序を変更することはできません。

Fabric Data Warehouse のワークスペースの既定の照合順序を変更する

このセクションでは、ワークスペース レベルでウェアハウスの既定の照合順序を構成する方法について説明します。この設定は、すべてのウェアハウスおよび SQL 分析エンドポイント項目に影響します。

Permissions

  • Fabric ワークスペース ロール管理者、メンバー、共同作成者のメンバー: ワークスペース設定パネルからワークスペースの照合順序を変更できます。
  • 閲覧者: 照合順序の設定は表示できますが、変更することはできません。

Fabric ポータルで Fabric Data Warehouse のワークスペースの既定の照合順序を変更する

  1. Microsoft Fabric ワークスペースに移動します。
  2. ワークスペースの [設定] を開きます。
  3. [ ワークスペースの設定 ] ウィンドウで、[ データ ウェアハウス ] タブを選択します。
  4. [照合順序] ページを選択します。
  5. 大文字と小文字の区別で、大文字と小文字を区別する (Latin1_General_100_BIN2_UTF8) (既定) または 大文字と小文字を区別しない (Latin1_General_100_CI_AS_KS_WS_SC_UTF8) を選択します。 このワークスペースで作成された 新しい ウェアハウスおよび SQL 分析エンドポイント項目は、選択したワークスペース照合順序で作成されます。
  6. ウェアハウスを作成した後、 Fabric Query エディター で次の T-SQL ステートメントを使用して、ウェアハウスの照合順序を確認します。 
    SELECT name, collation_name FROM sys.databases;

注

新しいミラー化された SQL Server データベース、ミラー化された SQL Managed Instance データベース、ミラー化された Azure SQL Database、または Fabric の SQL データベースの新しい SQL 分析エンドポイント項目では、親項目の照合順序ではなく、ファブリック ワークスペースの照合順序が使用されます。

REST API を使用して既定以外の照合順序を使用してウェアハウスを作成する

このセクションでは、Visual Studio Code を使用して、REST クライアント拡張機能を使用して既定以外の照合順序を持つウェアハウスを作成する方法について説明します。

API エンドポイント

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

倉庫の照合順序を含むdefaultCollationパラメーターでの、ウェアハウスを作成するためのサンプル 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 と REST クライアント拡張機能を使用して、既定以外の照合順序で新しいウェアハウスを簡単に作成できます。 次のステップを実行します。

  1. まだインストールしていない場合は、 Visual Studio Code をダウンロードしてインストールし、アプリケーションをダウンロードしてインストールします。

  2. REST クライアント - Visual Studio Marketplace をインストールします。

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

  4. ファイル本文に要求の詳細を入力します。 ヘッダーと本文の間には、"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" 
   } 
 }

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

    • <workspaceID>: /groups/ セクションの後の URL、または既存のウェアハウスで SELECT @@SERVERNAME を実行してワークスペース GUID を検索します。
    • <bearer token>: 次の手順に従ってベアラー トークンを取得します。
      1. ブラウザー (Microsoft Edge) で Microsoft Fabric ワークスペースを開きます。
      2. F12 キーを押して開発者ツールを開きます。
      3. [コンソール] タブを選択します。必要に応じて、[簡易ビューの展開] を選択して、コンソール プロンプト > を表示します。
      4. コマンド powerBIAccessToken を入力して、Enter キーを押します。 コンソールで返された大きな一意の文字列を右クリックし、[ 文字列の内容をコピー] を選択します。
      5. <bearer token> の代わりに貼り付けます。
    • <Warehouse name here>: 目的のウェアハウス名を入力します。
    • <Warehouse description here>: 目的のウェアハウスの説明を入力します。

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

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

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

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

    SELECT name, collation_name FROM sys.databases;

関連するコンテンツ

  • Last updated on