Habilidades para banco de dados SQL no Fabric

Aplica-se a:✅banco de dados SQL do Microsoft Fabric

Importante

Esse recurso está na versão prévia.

Skills for Fabric são instruções reutilizáveis que ajudam um assistente de programação de IA a entender cargas de trabalho, APIs, padrões de consulta e melhores práticas operacionais do Fabric. As habilidades para bancos de dados SQL fornecem orientações específicas para trabalhar em tarefas relacionadas a bancos de dados SQL no Fabric a partir de um ambiente agêntico de linha de comando ou de codificação.

Este artigo mostra como instalar o skill bundle do Fabric, conectar o assistente ao seu ambiente Fabric e usar as habilidades de autoria, consumo e operações de banco de dados SQL. As habilidades orientam o assistente; sua identidade, permissões, ferramentas e controles de segurança do Fabric ainda governam cada ação.

Pré-requisitos

Permissão para acessar o espaço de trabalho do Fabric e realizar as operações que você solicitar.
Uma ferramenta de codificação de IA, como GitHub Copilot CLI, Claude Code, Visual Studio Code, Cursor, Windsurf ou outra AGENTS.md ferramenta compatível.
Node.js: necessário para a CLI de GitHub Copilot autônoma, que é instalada como um pacote npm (npm install -g @github/copilot). Para obter as etapas completas de instalação, consulte Configurar GitHub Copilot CLI.
PowerShell 7: Necessário para GitHub Copilot CLI. Verifique com pwsh --version.
Git: necessário para clonar repositórios de habilidades para ferramentas que não usam o marketplace de plug-in.
CLI do Azure: a maioria das operações Fabric exige autenticação Azure. Depois de instalar, entre com az login.

Instale as habilidades do Microsoft Fabric

Abra a CLI do GitHub Copilot ou o Claude Code. Tanto a CLI GitHub Copilot quanto o Claude Code usam o mesmo fluxo de trabalho do marketplace de plug-in.
Adicione o marketplace público na linha de comando do GitHub Copilot:
```
/plugin marketplace add microsoft/skills-for-fabric
```
Adicione as habilidades para Fabric marketplace:
```
/plugin marketplace add microsoft/skills-for-fabric
```
Para ver todos os plugins e habilidades disponíveis no marketplace, insira: /plugin marketplace browse fabric-collection.
Instale a coleção Fabric.
```
/plugin install fabric-skills@fabric-collection
```
Para reduzir o escopo, instale um pacote focado, como fabric-operations, que inclui as sqldb-cli habilidades:
```
/plugin install fabric-operations@fabric-collection
```
Pare e reinicie sua ferramenta para carregar as habilidades:
```
/quit
```
Verifique a instalação:
```
/skills
```

Habilidades em banco de dados SQL

As seguintes habilidades são relevantes para o banco de dados SQL no Fabric:

Skill	Use-o para	Exemplo de intenção
`sqldb-authoring-cli`	Criar e modificar objetos ou dados de banco de dados.	Crie uma tabela, carregue linhas, adicione um índice ou implante um procedimento armazenado.
`sqldb-consumption-cli`	Descobrindo o esquema e executando consultas somente de leitura.	Liste tabelas, inspecione colunas, resuma ordens recentes ou explique um conjunto de resultados.
`sqldb-operations-cli`	Investigando questões de saúde, desempenho e operacionais.	Analise consultas lentas, identifique bloqueios ou revise o uso de recursos do banco de dados.

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

Como usar Habilidades com banco de dados SQL no Fabric

Abra um terminal no seu projeto ou pasta de trabalho.
Digite Copilot e selecione Enter.

GitHub Copilot é lançado.
Para autenticar com a identidade da Microsoft que tem acesso ao espaço de trabalho Fabric de destino, digite az login e siga os passos.

Desenvolver um banco de dados SQL

Use a habilidade sqldb-authoring-cli quando a tarefa altera o estado do banco de dados. Para criar ou atualizar objetos de banco de dados com o GitHub Copilot, sempre inclua o workspace de destino, banco de dados, ambiente, objeto, esquema esperado, restrições e se o assistente deve gerar apenas um script ou executá-lo após sua análise. Para mudanças de esquema ou de dados, você pode solicitar TRY...CATCH para lidar com erros e realizar um rollback da transação.

Tip

Comece com uma requisição somente leitura para gerar instruções T-SQL, depois revise qualquer instrução T-SQL gerada antes da execução.

Por exemplo, esses 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

Use a habilidade sqldb-consumption-cli para descoberta e análise somente leitura. Peça ao assistente para inspecionar os metadados primeiro, qualificar nomes de objetos, limitar o tamanho dos resultados e explicar as suposições.

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 banco de dados

Use a habilidade sqldb-operations-cli para analisar o desempenho e a confiabilidade. Forneça a janela de tempo, sintomas observados, carga de trabalho afetada e se o assistente pode coletar dados diagnósticos.

Por exemplo, as consultas a seguir 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.

Checklist para revisar e executar a consulta T-SQL

Confirme que o assistente selecionou a habilidade pretendida de banco de dados SQL.
Verifique os nomes do workspace, do banco de dados, do esquema e dos objetos.
Revise T-SQL gerado para operações destrutivas, comportamento de transações e escopo de dados.
Peça um resumo do impacto e um plano de reversão antes de fazer alterações. Para alterações no esquema, prepare um script de rollback ou um script T-SQL de reversão.
Execute-o somente quando o plano estiver de acordo com sua intenção.
Valide o resultado com uma consulta separada de somente leitura.

Segurança e uso responsável

As habilidades não contornam a autenticação do Microsoft Entra, permissões do Fabric, permissões SQL ou políticas organizacionais.
Sempre use 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 arquivos de projetos.
Trate SQL gerado como código proposto. Revise como faria qualquer outra alteração no banco de dados.
Prefira a descoberta em modo somente leitura antes da criação ou remediação.

Para mais informações, veja 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