Criar um banco de dados SQL com o Fabric CLI

Aplica-se a:✅Base de dados SQL em Microsoft Fabric

Você pode usar a Interface de Linha de Comando Fabric (CLI) para criar bancos de dados SQL no Fabric. A Fabric CLI (fab) é uma interface de linha de comando rápida e inspirada no sistema de ficheiros para o Microsoft Fabric.

Este artigo e scripts de exemplo demonstram os comandos básicos da CLI de malha que podem ser usados para implantar um banco de dados SQL de malha.

Pré-requisitos

Antes de começar:

• Você precisa de uma capacidade existente do Fabric. Caso não o faça, inicie uma avaliação dos serviços do Fabric.

• Você pode usar um espaço de trabalho existente ou criar um novo espaço de trabalho Fabric.

• Você deve ser membro das funções Administrador ou Membro do espaço de trabalho para criar um banco de dados SQL.

• Certifique-se de que o Python versão 3.10, 3.11 ou 3.12 está instalado na sua máquina. Python deve ser acessível a partir do seu terminal, através da PATH variável de ambiente.

• Instale a Fabric CLI na sua máquina com o seguinte comando. Se você vir uma mensagem sobre como atualizar o PATH na saída do instalador, corrija isso antes de prosseguir ou as etapas subsequentes podem falhar.

  pip install ms-fabric-cli
  

Criar uma nova base de dados SQL com o Fabric CLI

1. Inicie sessão no Microsoft Fabric. Abra um prompt de comando e execute o seguinte comando:

   fab auth login 
   

2. Siga as instruções para autenticar usando sua conta da Microsoft com acesso ao espaço de trabalho do Fabric.

3. Execute o seguinte comando para criar um novo banco de dados SQL:

   • Substitua <workspacename> pelo nome do espaço de trabalho onde você deseja criar o banco de dados SQL.
   • Substitua <databasename> pelo nome que você deseja usar para seu novo banco de dados SQL.

   fab create <workspacename>.Workspace/<databasename>.SQLDatabase
   

4. Verifique o novo banco de dados SQL em seu espaço de trabalho com o seguinte comando:

   • Substitua <workspacename> pelo nome do espaço de trabalho onde você deseja criar o banco de dados SQL.

   fab ls <workspacename>.Workspace 
   

   O fab ls comando exibe uma lista de todos os itens no espaço de trabalho, incluindo seu novo banco de dados SQL.

Agrupamento da base de dados

Por padrão, a base de dados é criada com a colação SQL_Latin1_General_CP1_CI_AS insensível a maiúsculas e minúsculas.

A colação de bases de dados não pode ser modificada após a criação, embora sejam suportadas colações em colunas individuais.

Quando crias a base de dados com a CLI do Fabric, podes chamar diretamente a API do Fabric com o conjunto de comandos da API do fab . Especifique, nos parâmetros, o espaço de trabalho desejado, o novo nome e descrição da base de dados, e a ordenação desejada.

Atualmente, o fab cli comando é necessário para criar uma base de dados com uma colação não padrão. A sintaxe é semelhante, por exemplo:

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

Este exemplo cria uma nova base de dados no espaço de trabalho com o ID único workspace unique ID, com o nome <new database name>, a descrição <new database description> e a colação Latin1_General_100_BIN2_UTF8.

Conteúdo relacionado

• CLI de Tecido
• Opções para criar um banco de dados SQL no portal do Fabric
• Guia de início rápido: conectar-se a um banco de dados SQL no Fabric com o driver Microsoft Python para SQL Server