Share via


Datawarehouse-sortering

Van toepassing op:✅ Warehouse in Microsoft Fabric

Fabric Data Warehouse ondersteunt zowel hoofdlettergevoelige als niet-hoofdlettergevoelige sorteringen. Ondersteunde magazijnsorteringen zijn:

  • Latin1_General_100_BIN2_UTF8 (standaard) (hoofdlettergevoelig)
  • Latin1_General_100_CI_AS_KS_WS_SC_UTF8 (hoofdlettergevoelig)

Nieuwe magazijnen en alle SQL-analyse-eindpunten worden geconfigureerd op basis van de standaardsorteringsinstelling datawarehouse van de werkruimte, die standaard de hoofdlettergevoelige sortering Latin1_General_100_BIN2_UTF8is.

Het wijzigen van de sortering op werkruimteniveau heeft geen invloed op bestaande magazijnen of SQL-analyse-eindpunten. Query's tussen magazijnen kunnen fouten of onverwachte queryresultaten voor items met verschillende sorteringen tegenkomen.

Een magazijn maken met een hoofdlettergevoelige sortering:

Belangrijk

Zodra een warehouse- of SQL-analyse-eindpunt is gemaakt, kan de sortering niet meer worden gewijzigd.

De standaardsortering van de werkruimte voor Fabric Data Warehouse wijzigen

In deze sectie wordt uitgelegd hoe u de standaardsortering voor magazijnen op werkruimteniveau configureert. Een instelling is van invloed op alle eindpuntitems voor magazijn- en SQL-analyse.

Permissions

  • Leden van de werkruimterollen Fabric admin, lid, inzender: kan de sortering van de werkruimte wijzigen vanuit het deelvenster met werkruimte-instellingen.
  • Viewers: Kan sorteringsinstellingen weergeven, maar deze niet wijzigen.

Standaardsortering van werkruimten wijzigen voor Fabric Data Warehouse in de Fabric-portal

  1. Ga naar de Microsoft Fabric-werkruimte.
  2. Open de werkruimte-instellingen.
  3. Selecteer in het venster Werkruimte-instellingen het tabblad DataWarehouse .
  4. Selecteer de pagina Sorteringen .
  5. Kies onder Hoofdlettergevoeligheidhoofdlettergevoelig (Latin1_General_100_BIN2_UTF8) (standaard) of niet-hoofdlettergevoelig (Latin1_General_100_CI_AS_KS_WS_SC_UTF8). Alle nieuwe warehouse- en SQL Analytics-eindpuntitems die in deze werkruimte zijn gemaakt, worden gemaakt met de gekozen werkruimtesortering.
  6. Nadat u een magazijn hebt gemaakt, gebruikt u de volgende T-SQL-instructie in de Fabric Query-editor om de sortering van uw magazijn te bevestigen:
    SELECT name, collation_name FROM sys.databases;
    

Opmerking

Het nieuwe SQL Analytics-eindpuntitem voor een nieuwe gespiegelde SQL Server-database, gespiegelde SQL Managed Instance-database, gespiegelde Azure SQL Database of SQL-database in Fabric maakt gebruik van de sortering van de infrastructuurwerkruimte, niet de sortering van het bovenliggende item.

Een magazijn maken met een niet-standaardsortering met REST API

In deze sectie wordt uitgelegd hoe u Visual Studio Code gebruikt om een magazijn te maken met een niet-standaardsortering met behulp van de REST Client-extensie.

API-eindpunt

Als u een magazijn met REST API wilt maken, gebruikt u het API-eindpunt: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Hier volgt een voorbeeld van een JSON-aanvraagbody voor het maken van een magazijn, inclusief de sortering van het magazijn in de defaultCollation parameter:

{ 
  "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 gebruiken om de REST API aan te roepen

U kunt eenvoudig een nieuw magazijn maken met een niet-standaardsortering met behulp van Visual Studio Code en de REST Client-extensie. Volg vervolgens deze stappen:

  1. Als dat nog niet het is gebeurd, downloadt en installeert u Visual Studio Code om de toepassing te downloaden en te installeren.

  2. Installeer de REST-client - Visual Studio Marketplace.

  3. Maak een nieuw tekstbestand in VS Code met de .http extensie.

  4. Voer de aanvraaggegevens in de hoofdtekst van het bestand in. Er moet een lege ruimte zijn tussen de koptekst en de hoofdtekst, die geplaatst is na de regel 'Autorisatie'.

      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. Vervang de waarden van de tijdelijke aanduidingen:

    • <workspaceID>: Zoek de GUID van de werkruimte in de URL na de /groups/ sectie, of door de opdracht SELECT @@SERVERNAME uit te voeren in een bestaand magazijn.
    • <bearer token>: Haal het Bearer-token op door de volgende stappen uit te voeren:
      1. Open uw Microsoft Fabric-werkruimte in een browser (Microsoft Edge).
      2. Druk op F12 om Ontwikkelhulpprogramma's te openen.
      3. Selecteer het tabblad Console . Selecteer indien nodig Snelle weergave uitvouwen om de consoleprompt weer te geven >.
      4. Typ de opdracht powerBIAccessToken en druk op Enter. Klik met de rechtermuisknop op de grote unieke tekenreeks die wordt geretourneerd in de console en selecteer Tekenreeksinhoud kopiëren.
      5. Plak het in plaats van <bearer token>.
    • <Warehouse name here>: Voer de gewenste magazijnnaam in.
    • <Warehouse description here>: Voer de gewenste magazijnbeschrijving in.
  6. Selecteer de link Verzoek verzenden die boven uw POST-opdracht in de VS Code-editor wordt weergegeven.

  7. U ontvangt een antwoord met de statuscode 202 Geaccepteerd, samen met andere details over uw POST-aanvraag.

  8. Ga naar het zojuist gemaakte magazijn in de Fabric-portal.

  9. Voer de volgende T-SQL-instructie uit in de Query-editor om te bevestigen dat de sortering voor uw magazijn overeenkomt met wat u hebt opgegeven in de JSON:

    SELECT name, collation_name FROM sys.databases;