適用対象:✅ Microsoft Fabric の SQL データベース
Fabric コマンド ライン インターフェイス (CLI) を使用して、Fabric で SQL データベースを作成できます。 Fabric CLI (fab) は、Microsoft Fabric 用の高速なファイル システムに着想を得たコマンド ライン インターフェイスです。
この記事とサンプル スクリプトでは、Fabric SQL データベースのデプロイに使用できる基本的な Fabric CLI コマンドを示します。
[前提条件]
開始する前に、次の手順を実行します。
既存の Fabric 容量が必要です。 そうでない場合は、Fabric 試用版を開始します。
既存のワークスペースを使用するか、新しい Fabric ワークスペースを作成することができます。
SQL データベースを作成するには、 ワークスペースの管理者ロールまたはメンバー ロールの メンバーである必要があります。
Python バージョン 3.10、3.11、または 3.12 がコンピューターにインストールされていることを確認します。
PATH環境変数を使用して、ターミナルから Python にアクセスできる必要があります。次のコマンドを使用して、コンピューターに Fabric CLI をインストールします。 インストーラーの出力に
PATHの更新に関するメッセージが表示された場合は、続行する前に、または後続の手順が失敗する可能性があることを修正してください。pip install ms-fabric-cli
Fabric CLI を使用して新しい SQL データベースを作成する
Microsoft Fabric にサインインします。 コマンド プロンプトを開き、次のコマンドを実行します。
fab auth loginプロンプトに従って、Fabric ワークスペースへのアクセス権を持つ Microsoft アカウントを使用して認証します。
次のコマンドを実行して、新しい SQL データベースを作成します。
-
<workspacename>を、SQL データベースを作成するワークスペースの名前に置き換えます。 -
<databasename>を、新しい SQL データベースに使用する名前に置き換えます。
fab create <workspacename>.Workspace/<databasename>.SQLDatabase-
次のコマンドを使用して、ワークスペース内の新しい SQL データベースを確認します。
-
<workspacename>を、SQL データベースを作成するワークスペースの名前に置き換えます。
fab ls <workspacename>.Workspacefab lsコマンドを実行すると、ワークスペース内のすべての項目 (新しい SQL データベースを含む) の一覧が表示されます。-
データベースの照合順序
既定では、データベースは大文字と小文字を区別しない照合順序 SQL_Latin1_General_CP1_CI_ASで作成されます。
データベースの照合順序は作成後に変更できませんが、個々の列の照合順序はサポートされています。
Fabric CLI を使用してデータベースを作成する場合は、Fab API のコマンド セットを使用して Fabric API を直接呼び出すことができます。 パラメーターに、目的のワークスペース、新しいデータベース名と説明、および必要な照合順序を指定します。
現時点では、既定以外の照合順序を使用してデータベースを作成するには、 fab cli コマンドが必要です。 構文は似ています。次に例を示します。
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\"}}"
この例では、名前workspace unique ID、説明<new database name>、照合順序<new database description>を使用して、一意の ID Latin1_General_100_BIN2_UTF8を持つ新しいデータベースをワークスペースに作成します。