Partager via

Procédure : créer un entrepôt avec un classement qui ne respecte pas la casse

  • Article

S'applique à :✅ Entrepôt dans Microsoft Fabric

Tous les entrepôts Fabric sont configurés par défaut avec un classement qui respecte la casse Latin1_General_100_BIN2_UTF8. Vous pouvez également créer des entrepôts avec un classement qui ne respecte pas la casse - Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Pour le moment, la seule méthode disponible pour créer un entrepôt de données qui ne respecte pas la casse consiste à utiliser l’API REST. Cet article fournit un guide pas à pas sur la création d’un entrepôt avec un classement qui ne respecte pas la casse via l’API REST. Il explique également comment utiliser Visual Studio Code avec l’extension REST Client pour faciliter le processus.

Important

Une fois qu’un entrepôt est créé, le paramètre de classement ne peut plus être changé. Réfléchissez soigneusement à vos besoins avant de lancer le processus de création.

Prérequis

Point de terminaison d’API

Pour créer un entrepôt avec l’API REST, utilisez le point de terminaison d’API : POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Voici un exemple de corps de la demande JSON pour la création d’un entrepôt :

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

Utiliser Visual Studio Code pour appeler l’API REST

Vous pouvez facilement créer un entrepôt avec un classement qui ne respecte pas la casse à l’aide de Visual Studio Code (VS Code) et l’extension REST Client. Effectuez les étapes suivantes :

  1. Créez un fichier texte dans VS Code avec l’extension .http.

  2. Entrez les détails de la requête dans le corps du fichier. Notez qu’un espace vide doit être présent entre l’en-tête et le corps, après la ligne « 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. Remplacez les valeurs d’espace réservé :

    • <workspaceID> : recherchez le GUID de l’espace de travail dans l’URL après la section /groups/, ou en exécutant SELECT @@SERVERNAME dans un entrepôt existant.
    • <bearer token> : pour l’obtenir, suivez ces étapes :
      1. Ouvrez votre espace de travail Microsoft Fabric dans un navigateur (Microsoft Edge ou Google Chrome).
      2. Appuyez sur F12 pour ouvrir les Outils de développement.
      3. Sélectionnez l’onglet Console. Si nécessaire, sélectionnez Développer Affichage rapide pour faire apparaître l’invite de console >.
      4. Tapez la commande copy(powerBIAccessToken), puis appuyez sur Entrée. Même si la console répond « undefined », le jeton du porteur est copié dans votre Presse-papiers.
      5. Collez-le à la place de <bearer token>.
    • <Warehouse name here> : entrez le nom souhaité pour l’entrepôt.
    • <Warehouse description here> : entrez la description souhaitée pour l’entrepôt.

  4. Sélectionnez le lien Envoyer la demande affiché au-dessus de votre commande POST dans l’éditeur VS Code.

  5. Vous devez recevoir une réponse avec le code d’état 202 Accepted ainsi que des détails supplémentaires sur votre requête POST.

  6. Accédez à l’entrepôt qui vient d’être créé dans le portail Fabric.

  7. Exécutez l’instruction T-SQL suivante dans l’Éditeur de requête pour vérifier que le classement de votre entrepôt correspond à ce que vous avez spécifié dans le contenu JSON ci-dessus :

    SELECT name, collation_name FROM sys.databases;

Contenu connexe