Competências para base de dados SQL no Fabric

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

Importante

Skills for Fabric são instruções reutilizáveis que ajudam um assistente de programação com IA a compreender cargas de trabalho do Fabric, APIs, padrões de consulta e melhores práticas operacionais. As competências da base de dados SQL fornecem orientações específicas para tarefas sobre como trabalhar com uma base de dados SQL no Fabric a partir de um ambiente agêntico de linha de comandos ou de programação.

Este artigo mostra como instalar o Fabric skill bundle, ligar o assistente ao seu ambiente Fabric e utilizar as competências de autoria, consumo e operações de bases de dados SQL. As competências orientam o assistente; a sua identidade, permissões, ferramentas e controlos de segurança do Fabric continuam a governar todas as ações.

Pré-requisitos

Permissão para aceder ao espaço de trabalho do Fabric e realizar as operações que solicita.
Uma ferramenta de programação por IA, como GitHub Copilot CLI, Claude Code, Visual Studio Code, Cursor, Windsurf ou outra AGENTS.md ferramenta compatível.
Node.js: Obrigatório para o GitHub Copilot standalone CLI, que se instala como um pacote npm (npm install -g @github/copilot). Para passos completos de configuração, veja Configurar GitHub Copilot CLI.
PowerShell 7: Necessário para a CLI do GitHub Copilot. Verifique com pwsh --version.
Git: É necessário para clonar repositórios de competências para ferramentas que não utilizam o mercado de plugins.
CLI do Azure: A maioria das operações Fabric requer autenticação Azure. Após a instalação, inicie sessão com az login.

Instale as funcionalidades do Microsoft Fabric

Abre o GitHub Copilot CLI ou Claude Code. Tanto o GitHub Copilot CLI como o Claude Code usam o mesmo fluxo de trabalho do marketplace de plugins.

Adicione o mercado público no GitHub Copilot CLI:

/plugin marketplace add microsoft/skills-for-fabric

Adicione o marketplace do Skills for Fabric:
```
/plugin marketplace add microsoft/skills-for-fabric
```
Para ver todos os plugins e competências disponíveis no marketplace, introduza: /plugin marketplace browse fabric-collection.
Instala a coleção Fabric.
```
/plugin install fabric-skills@fabric-collection
```
Para reduzir o âmbito, instale um pacote focado, como fabric-operations, que inclui as sqldb-cli competências:
```
/plugin install fabric-operations@fabric-collection
```
Feche e reinicie a sua ferramenta para carregar as capacidades:
```
/quit
```
Verifique a instalação:
```
/skills
```

Competências em bases de dados SQL

As seguintes competências são relevantes para a base de dados SQL no Fabric:

Skill	Usa-o para	Exemplo de intenção
`sqldb-authoring-cli`	Criação e modificação de objetos ou dados da base de dados.	Crie uma tabela, carregue linhas, adicione um índice ou implemente um procedimento armazenado.
`sqldb-consumption-cli`	Descobrir o esquema e executar consultas apenas de leitura.	Liste tabelas, inspecione colunas, resuma ordens recentes ou explique um conjunto de resultados.
`sqldb-operations-cli`	Investigação de questões de saúde, desempenho e operacionais.	Analisar consultas lentas, identificar bloqueios ou rever o uso dos recursos da base de dados.

Para o catálogo completo das competências disponíveis em todas as cargas de trabalho do Fabric, veja GitHub: Skills for Fabric.

Como usar Competências com base de dados SQL no Fabric

Abre um terminal no teu projeto ou pasta de trabalho.
Digite Copilot e selecione Enter.

Lançamento do GitHub Copilot.
Para autenticar com a identidade Microsoft que tem acesso ao espaço de trabalho Fabric alvo, escreva az login e siga os passos.

Desenvolver uma base de dados SQL

Usa a sqldb-authoring-cli habilidade quando a tarefa muda de estado da base de dados. Para criar ou atualizar objetos de base de dados com o GitHub Copilot, inclua sempre o espaço de trabalho de destino, base de dados, ambiente, objeto, esquema esperado, restrições e se o assistente deve gerar apenas um script ou executá-lo após a sua revisão. Para alterações de esquema ou de dados, pode pedir TRY...CATCH para lidar com erros e realizar uma reversão da transação.

Tip

Comece com um pedido de apenas leitura para gerar instruções T-SQL, depois reveja qualquer instrução T-SQL gerada antes da execução.

Por exemplo, estes prompts de exemplo podem ser usados para criar e carregar uma tabela com dados de exemplo.

In the Sales SQL database, create a dbo.CustomerFeedback table with an identity key, 
customer ID, feedback text, sentiment, created date, and a foreign key to 
dbo.Customer.CustomerID. All columns should be nullable. The create date should 
be populated by a default. Generate the T-SQL for review; don't execute it.

Generate 100 sample data rows for the dbo.CustomerFeedback as a single 
INSERT statement, referencing rows in the dbo.Customer table. 
Generate a TRY...CATCH structure to handle any errors and rollback. 
Do not execute the script, let me review.

Explorar e consultar dados

Utilize a competência sqldb-consumption-cli para descoberta e análise em modo de leitura. Peça ao assistente para inspecionar primeiro os metadados, qualificar os nomes dos objetos, limitar o tamanho dos resultados e explicar pressupostos.

Por exemplo, use o Copilot para consultar metadados ou dados de tabelas:

List the user tables and views in the Sales SQL database and describe their relationships. 
Don't modify any objects.

Find the top 10 products by revenue in the last 30 days. 
Show the T-SQL and summarize the result.

Inspect the available columns before answering: 
Which customers have not placed an order in the last 90 days?

Investigar operações de base de dados

Utilize a competência sqldb-operations-cli para investigar o desempenho e a fiabilidade. Forneça a janela temporal, sintomas observados, carga de trabalho afetada e se o assistente consegue recolher dados de diagnóstico.

Por exemplo, as consultas seguintes investigam problemas de desempenho atuais ou passados, ou ajustam o desempenho das consultas.

Investigate why the nightly order-processing query slowed down between 01:00 and 02:00 UTC. 
Start with read-only diagnostics and rank the likely causes.

Check for blocking sessions and long-running requests. 
Explain the evidence before recommending a mitigation.

Review this execution plan and suggest indexes only when the expected benefit and write overhead are clear.

Lista de verificação para rever e executar a consulta T-SQL

Confirma que o assistente selecionou a competência pretendida para a base de dados SQL.
Verifique o espaço de trabalho, base de dados, esquema e nomes dos objetos.
Reveja o T-SQL gerado quanto a operações destrutivas, comportamento das transações e âmbito dos dados.
Peça um resumo de impacto e uma abordagem de retrocesso antes de criar as alterações. Para alterações de esquema, prepare um script T-SQL de reversão ou anulação.
Executa apenas depois de o plano corresponder à tua intenção.
Valide o resultado com uma consulta separada de apenas leitura.

Segurança e uso responsável

As aptidões não contornam a autenticação do Microsoft Entra, as permissões do Fabric, as permissões do SQL nem as políticas organizacionais.
Use sempre identidades de menor privilégio e metas separadas de desenvolvimento, teste e produção.
Não coloque segredos, tokens de acesso ou dados sensíveis em prompts ou ficheiros de projeto.
Trate o SQL gerado como código proposto. Revê-o como farias com qualquer outra alteração na base de dados.
Prefira a deteção em modo só de leitura antes de proceder à criação ou à remediação.

Para mais informações, consulte Privacidade, segurança e uso responsável de IA do Copilot no Fabric.

Comentários

Esta página foi útil?

Last updated on 2026-08-18