Sdílet prostřednictvím


Postupy: Vytvoření skladu s rozlišováním velkých a malých písmen (CI) kolací

Platí pro:✅ Warehouse v Microsoft Fabric

Ve výchozím nastavení jsou všechny sklady Fabric nakonfigurované s kolací s rozlišováním velkých a malých písmen (CS) Latin1_General_100_BIN2_UTF8. Můžete také vytvořit sklady bez rozlišování velkých a malých písmen (CI) – Latin1_General_100_CI_AS_KS_WS_SC_UTF8.

Jedinou dostupnou metodou pro vytvoření datového skladu nerozlišující malá a velká písmena je v současné době prostřednictvím rozhraní REST API. Tento článek obsahuje podrobný průvodce vytvořením skladu s rozlišováním velkých a malých písmen prostřednictvím rozhraní REST API. Vysvětluje také, jak pomocí editoru Visual Studio Code s rozšířením REST Client usnadnit proces.

Důležité

Po vytvoření skladu nelze nastavení kolace změnit. Před zahájením procesu vytváření pečlivě zvažte své potřeby.

Požadavky

Koncový bod rozhraní API

K vytvoření skladu s rozhraním REST API použijte koncový bod rozhraní API: POST https://api.fabric.microsoft.com/v1/workspaces/<workspace-id>/items

Tady je ukázkový text požadavku JSON pro vytvoření skladu:

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

Použití editoru Visual Studio Code k vyvolání rozhraní REST API

Pomocí editoru Visual Studio Code (VS Code) a rozšíření rest Client můžete snadno vytvořit nový sklad bez rozlišování velkých a malých písmen. Postupujte následovně:

  1. Vytvořte nový textový soubor ve VS Code s příponou .http .

  2. Do textu souboru zadejte podrobnosti požadavku. Všimněte si, že mezi záhlavím a textem by mělo být prázdné místo umístěné za řádkem Autorizace.

      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. Nahraďte zástupné hodnoty:

    • <workspaceID>: Vyhledejte identifikátor GUID pracovního prostoru v adrese URL za /groups/ oddílem nebo spuštěním SELECT @@SERVERNAME v existujícím skladu.

    • <bearer token>: Získejte to podle následujících kroků:

      1. Otevřete pracovní prostor Microsoft Fabric v prohlížeči (Microsoft Edge nebo Google Chrome).
      2. Stisknutím klávesy F12 otevřete Vývojářské nástroje.
      3. Vyberte kartu Konzola. V případě potřeby výběrem možnosti Rozbalit rychlé zobrazení zobrazte výzvu >konzoly .
      4. Zadejte příkaz copy(powerBIAccessToken) a stiskněte Enter. Zatímco konzola reaguje nedefinovaná, nosný token se zkopíruje do schránky.
      5. Vložte ho <bearer token>místo .

      Poznámka

      V některých scénářích může copy(powerBIAccessToken) selhat s chybou uncaught TypeError: copy is not a function, pokud je na stránce nějaké ID elementu s názvem copy. V takových případech ručně odeberte ID elementu pomocí následujícího příkazu před použitím funkce "copy": document.querySelector('#copy').remove().

    • <Warehouse name here>: Zadejte požadovaný název skladu.

    • <Warehouse description here>: Zadejte popis požadovaného skladu.

  4. V editoru VS Code vyberte odkaz Odeslat žádost, který se zobrazí přes příkaz POST.

  5. Měla by se zobrazit odpověď se stavovým kódem 202 Přijato, spolu s dalšími podrobnostmi o vaší žádosti POST.

  6. Přejděte na nově vytvořený sklad na portálu Fabric.

  7. V editoru dotazů spusťte následující příkaz T-SQL a ověřte, že kolace pro váš sklad odpovídá tomu, co jste zadali v kódu JSON výše:

    SELECT name, collation_name FROM sys.databases;