Udostępnij za pośrednictwem

Tworzenie bazy danych SQL przy użyciu Fabric CLI

Dotyczy:✅Baza danych SQL w usłudze Microsoft Fabric

Interfejs wiersza poleceń (CLI) Fabric umożliwia tworzenie baz danych SQL w Fabric. Interfejs wiersza poleceń Fabric (fab) to szybki interfejs wiersza poleceń inspirowany przez system plików dla usługi Microsoft Fabric.

W tym artykule i przykładowych skryptach przedstawiono podstawowe polecenia interfejsu wiersza polecenia Fabric CLI, których można użyć do uruchomienia bazy danych SQL Fabric.

Wymagania wstępne

Przed rozpoczęciem:

  • Potrzebujesz istniejącej przepustowości Fabryki. Jeśli tego nie zrobisz, uruchom wersję próbną usługi Fabric.

  • Możesz użyć istniejącego obszaru roboczego lub utworzyć nowy obszar roboczy usługi Fabric.

  • Aby utworzyć bazę danych SQL, musisz być członkiem ról administratora lub członka obszaru roboczego .

  • Upewnij się, że na maszynie zainstalowano język Python w wersji 3.10, 3.11 lub 3.12 . Język Python powinien być dostępny z poziomu terminalu za pośrednictwem zmiennej środowiskowej PATH .

  • Zainstaluj Fabric CLI na maszynie przy użyciu następującego polecenia. Jeśli zostanie wyświetlony komunikat o zaktualizowaniu PATH elementu w danych wyjściowych instalatora, napraw to przed kontynuowaniem, lub kolejne kroki mogą zakończyć się niepowodzeniem.

    pip install ms-fabric-cli

Tworzenie nowej bazy danych SQL przy użyciu interfejsu wiersza polecenia usługi Fabric

  1. Zaloguj się do usługi Microsoft Fabric. Otwórz wiersz polecenia i uruchom następujące polecenie:

    fab auth login

  2. Postępuj zgodnie z monitami, aby uwierzytelnić się przy użyciu konta Microsoft z dostępem do obszaru roboczego usługi Fabric.

  3. Uruchom następujące polecenie, aby utworzyć nową bazę danych SQL:

    • Zastąp <workspacename> ciąg nazwą obszaru roboczego, w którym chcesz utworzyć bazę danych SQL.
    • Zastąp <databasename> nazwą, której chcesz użyć dla nowej bazy danych SQL.
    fab create <workspacename>.Workspace/<databasename>.SQLDatabase

  4. Sprawdź nową bazę danych SQL w obszarze roboczym za pomocą następującego polecenia:

    • Zastąp <workspacename> ciąg nazwą obszaru roboczego, w którym chcesz utworzyć bazę danych SQL.
    fab ls <workspacename>.Workspace

    Polecenie fab ls wyświetla listę wszystkich elementów w obszarze roboczym, w tym nową bazę danych SQL.

Sortowanie bazy danych

Domyślnie baza danych jest tworzona z sortowaniem bez uwzględniania wielkości liter SQL_Latin1_General_CP1_CI_AS.

Sortowanie bazy danych nie może być modyfikowane po utworzeniu, chociaż sortowanie poszczególnych kolumn jest obsługiwane.

Podczas tworzenia bazy danych przy użyciu Fabric CLI można bezpośrednio wywołać interfejs API Fabric przy użyciu zestawu poleceń fab api. Określ żądany obszar roboczy, nazwę i opis nowej bazy danych oraz żądane sortowanie w parametrach.

fab cli Obecnie polecenie jest niezbędne do utworzenia bazy danych z niestandardowym sortowaniem. Składnia jest podobna, na przykład:

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\"}}"

W tym przykładzie zostanie utworzona nowa baza danych w obszarze roboczym o unikatowym identyfikatorze workspace unique IDz nazwą <new database name>, opisem <new database description>i sortowaniem Latin1_General_100_BIN2_UTF8.

Treści powiązane

  • Last updated on