Delen via

Procedure: Een magazijn maken met niet-hoofdlettergevoelige (CI)-sortering

  • Artikel

Van toepassing op:✅ Warehouse in Microsoft Fabric

Alle Fabric-magazijnen worden standaard geconfigureerd met een hoofdlettergevoelige sortering (CS) Latin1_General_100_BIN2_UTF8. U kunt ook magazijnen maken met niet-hoofdlettergevoelige (CI)-sortering - Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Momenteel is de enige methode die beschikbaar is voor het maken van een niet-hoofdlettergevoelig datawarehouse via REST API. Dit artikel bevat een stapsgewijze handleiding voor het maken van een magazijn met hoofdlettergevoelige sortering via de REST API. Ook wordt uitgelegd hoe u Visual Studio Code gebruikt met de REST Client-extensie om het proces te vergemakkelijken.

Belangrijk

Zodra een magazijn is gemaakt, kan de sorteringsinstelling niet meer worden gewijzigd. Houd zorgvuldig rekening met uw behoeften voordat u het aanmaakproces start.

Vereisten

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:

{ 
  "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 hoofdlettergevoelige sortering met behulp van Visual Studio Code (VS Code) en de REST Client-extensie . Volg vervolgens deze stappen:

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

  2. Voer de aanvraaggegevens in de hoofdtekst van het bestand in. Houd er rekening mee dat er een lege spatie moet zijn tussen de koptekst en de hoofdtekst, geplaatst 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" 
   } 
 }

  3. Vervang de waarden van de tijdelijke aanduidingen:

    • <workspaceID>: Zoek de werkruimte-GUID in de URL na de /groups/ sectie of door deze uit te voeren SELECT @@SERVERNAME in een bestaand magazijn.
    • <bearer token>: U kunt dit verkrijgen door de volgende stappen uit te voeren:
      1. Open uw Microsoft Fabric-werkruimte in een browser (Microsoft Edge of Google Chrome).
      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 copy(powerBIAccessToken) en druk op Enter. Terwijl de console niet-gedefinieerd reageert, wordt het Bearer-token gekopieerd naar het Klembord.
      5. Plak het in plaats van <bearer token>.
    • <Warehouse name here>: Voer de gewenste magazijnnaam in.
    • <Warehouse description here>: Voer de gewenste magazijnbeschrijving in.

  4. Selecteer de koppeling Aanvraag verzenden die wordt weergegeven via de POST-opdracht in de VS Code-editor.

  5. U ontvangt een antwoord met de statuscode 202 Geaccepteerd, samen met aanvullende informatie over uw POST-aanvraag.

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

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

    SELECT name, collation_name FROM sys.databases;

Gerelateerde inhoud