Sdílet prostřednictvím


Vytvoření databáze SQL pomocí rozhraní příkazového řádku Fabric

platí pro:databáze SQL v Microsoft Fabric

K vytváření databází SQL v platformě Fabric můžete použít rozhraní příkazového řádku (CLI). Rozhraní příkazového řádku Fabric CLI (fab) je rychlé, příkazové rozhraní inspirované systémem souborů pro Microsoft Fabric.

Tento článek a ukázkové skripty demonstrují základní příkazy Fabric CLI, které je možné použít k nasazení SQL databáze Fabric.

Požadavky

Než začnete:

  • Potřebujete existující kapacitu Fabric. Pokud ne, spusťte zkušební verzi Fabric.

  • Můžete použít existující pracovní prostor nebo vytvořit nový pracovní prostor Fabric.

  • Abyste mohli vytvořit databázi SQL, musíte být členem role správce nebo člena pracovního prostoru .

  • Ujistěte se, že je na vašem počítači nainstalovaný Python verze 3.10, 3.11 nebo 3.12 . Python měl by být přístupný z vašeho terminálu prostřednictvím proměnné prostředí PATH.

  • Pomocí následujícího příkazu nainstalujte na počítač rozhraní příkazového řádku Fabric CLI. Pokud se zobrazí zpráva o aktualizaci PATH v výstupu instalačního programu, opravte ho před pokračováním nebo následné kroky mohou selhat.

    pip install ms-fabric-cli
    

Vytvoření nové databáze SQL pomocí rozhraní příkazového řádku Fabric

  1. Přihlaste se k Microsoft Fabric. Otevřete příkazový řádek a spusťte následující příkaz:

    fab auth login 
    
  2. Postupujte podle pokynů k ověření pomocí účtu Microsoft s přístupem k vašemu pracovnímu prostoru Fabric.

  3. Spuštěním následujícího příkazu vytvořte novou databázi SQL:

    • Nahraďte <workspacename> názvem pracovního prostoru, ve kterém chcete vytvořit databázi SQL.
    • Nahraďte <databasename> názvem, který chcete použít pro novou databázi SQL.
    fab create <workspacename>.Workspace/<databasename>.SQLDatabase
    
  4. Pomocí následujícího příkazu ověřte novou databázi SQL v pracovním prostoru:

    • Nahraďte <workspacename> názvem pracovního prostoru, ve kterém chcete vytvořit databázi SQL.
    fab ls <workspacename>.Workspace 
    

    Příkaz fab ls zobrazí seznam všech položek v pracovním prostoru, včetně nové databáze SQL.

Porovnávání databáze

Ve výchozím nastavení je databáze vytvořena pomocí kolace SQL_Latin1_General_CP1_CI_ASnerozlišující velká a malá písmena .

Kolace databáze nelze po vytvoření změnit, i když jsou podporovány kolace jednotlivých sloupců.

Při vytváření databáze pomocí rozhraní příkazového řádku Fabric můžete rozhraní API Fabric volat přímo pomocí příkazů ze sady fab api. Zadejte požadovaný pracovní prostor, název a popis nové databáze a požadované kolace v parametrech.

fab cli V současné době je příkaz nutný k vytvoření databáze, která nemá výchozí kolaci. Syntaxe je podobná, například:

fab api workspaces/<workspace unique ID>/sqldatabases -X post -H "Content-Type=application/json" -i "{\"displayName\": \"<new database name>\", \"description\": \"<new database description>\", \"creationPayload\":{\"collation\": \"Latin1_General_100_BIN2_UTF8\",\"creationMode\": \"new\"}}"

Tento příklad vytvoří v pracovním prostoru novou databázi s jedinečným ID workspace unique ID, s názvem <new database name>, popisem <new database description>a kolací Latin1_General_100_BIN2_UTF8.