Freigeben über

Erstellen eines Warehouses mit CI-Sortierung (ohne Berücksichtigung von Groß-/Kleinschreibung)

  • Artikel

Gilt für:✅ Warehouse in Microsoft Fabric

Standardmäßig werden alle Fabric-Warehoueses mit der CS-Sortierfunktion (mit Berücksichtigung von Groß-/Kleinschreibung): Latin1_General_100_BIN2_UTF8 konfiguriert. Sie können auch Warehoueses auch mit CI-Sortierung (ohne Berücksichtigung von Groß-/Kleinschreibung) erstellen: Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Derzeit kann ein Data Warehouse mit Sortierung unter Berücksichtigung von Groß-/Kleinschreibung nur über die REST-API erstellt werden. Dieser Artikel enthält eine Schritt-für-Schritt-Anleitung zum Erstellen eines Warehouses mit Sortierung ohne Berücksichtigung von Groß-/Kleinschreibung über die REST-API. Außerdem wird erläutert, wie Sie Visual Studio Code mit der REST-Clienterweiterung verwenden, um den Prozess zu vereinfachen.

Wichtig

Nachdem ein Warehouse erstellt wurde, kann die Sortiereinstellung nicht mehr geändert werden. Überlegen Sie daher vor der Initiierung des Erstellungsprozesses genau, welche Anforderungen Sie stellen.

Voraussetzungen

API-Endpunkt

Verwenden Sie den API-Endpunkt POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items, um mit der REST-API ein Warehouse zu erstellen.

Im Folgenden finden Sie ein Beispiel für einen JSON-Anforderungstext zum Erstellen eines Warehouses:

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

Verwenden von Visual Studio Code zum Aufrufen der REST-API

Mit Visual Studio Code (VS Code) und der REST-Clienterweiterung können Sie ganz einfach ein neues Warehouse mit Sortierung ohne Berücksichtigung von Groß-/Kleinschreibung erstellen. Führen Sie folgende Schritte aus:

  1. Erstellen Sie in VS Code eine neue Textdatei mit der Erweiterung .http.

  2. Geben Sie die Anforderungsdetails im Dateitext ein. Beachten Sie, dass zwischen Header und Textkörper ein Leerraum hinter der Zeile „Authorization“ eingefügt werden sollte.

      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. Ersetzen Sie folgende Platzhalterwerte:

    • <workspaceID>: Suchen Sie die Arbeitsbereich-GUID in der URL nach dem Abschnitt /groups/ oder führen Sie dazu SELECT @@SERVERNAME in einem vorhandenen Warehouse aus.
    • <bearer token>: Führen Sie zum Abrufen die folgenden Schritten aus:
      1. Öffnen Sie Ihren Microsoft Fabric-Arbeitsbereich in einem Browser (Microsoft Edge oder Google Chrome).
      2. Drücken Sie F12, um die Entwicklungstools zu öffnen.
      3. Klicken Sie auf die Registerkarte Konsole. Wählen Sie bei Bedarf Schnellansicht erweitern aus, um die Konsoleneingabeaufforderung > anzuzeigen.
      4. Geben Sie den Befehl copy(powerBIAccessToken) ein, und drücken Sie die EINGABETASTE. Während die Konsole undefiniert reagiert, wird das Bearertoken in die Zwischenablage kopiert.
      5. Fügen Sie es anstelle von <bearer token> ein.
    • <Warehouse name here>: Geben Sie den gewünschten Warehousenamen ein.
    • <Warehouse description here>: Geben Sie die gewünschte Warehousebeschreibung ein.

  4. Wählen Sie im VS Code-Editor den Link Anforderung senden aus, der über Ihrem POST-Befehl angezeigt wird.

  5. Sie sollten eine Antwort mit dem Statuscode 202 – Akzeptiert zusammen mit zusätzlichen Details zu Ihrer POST-Anforderung erhalten.

  6. Wechseln Sie im Fabric-Portal zum neu erstellten Warehouse.

  7. Führen Sie die folgende T-SQL-Anweisung im Abfrage-Editor aus, um zu überprüfen, ob die Sortierung für Ihr Warehouse mit der im JSON-Code oben angegebenen Sortierung übereinstimmt:

    SELECT name, collation_name FROM sys.databases;

Zugehöriger Inhalt