Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
As instruções de banco de dados fornecem ao GitHub Copilot no SSMS (SQL Server Management Studio) o contexto específico do banco de dados e as diretrizes que residem diretamente no banco de dados. Os proprietários e as equipes de banco de dados podem usá-los para descrever regras de negócios, convenções de dados e padrões de uso. Com as instruções do banco de dados, o Copilot pode gerar respostas mais precisas, significativas e consistentes quando os usuários fazem perguntas ou escrevem consultas. As instruções de banco de dados atuam como documentação dinâmica que viaja com o banco de dados e é aplicada automaticamente durante as interações do Copilot.
Neste artigo, você aprenderá a usar instruções de banco de dados, que capacitam ainda mais os usuários e o Copilot a encontrar os objetos e informações corretos mais rapidamente. Esse recurso ajuda a reduzir o tempo gasto fornecendo banco de dados, negócios e conhecimento interno para o Copilot.
Para obter informações relacionadas sobre o GitHub Copilot Chat, consulte Use a experiência de chat do GitHub Copilot no SQL Server Management Studio (versão prévia).
Como funcionam as instruções do banco de dados
As instruções de banco de dados são armazenadas como metadados no banco de dados, o que permite que o Copilot as descubra e aplique automaticamente em runtime. Quando um usuário interage com o GitHub Copilot para um banco de dados, como fazer uma pergunta em linguagem natural ou gerar T-SQL, o Copilot incorpora essas instruções como contexto extra. Esse contexto garante que as respostas reflitam definições de negócios, tabelas canônicas e regras específicas de domínio, em vez de depender apenas de nomes de esquema ou adivinhações. As instruções persistem entre as sessões e estão disponíveis para qualquer usuário que acesse o mesmo banco de dados.
Pré-requisitos
As instruções de banco de dados para o GitHub Copilot no SSMS dependem de informações em propriedades estendidas.
Instale o SSMS 22.3 ou uma versão posterior com a carga de trabalho de Assistência de IA.
Entre em sua conta do GitHub que possui acesso ao Copilot.
Use o GitHub Copilot de graça. Inscreva-se e use a IA para codificar de forma mais rápida e eficiente.
Usar o GitHub Copilot para adicionar ou exibir instruções de banco de dados
Estas etapas mostram como criar e usar instruções de banco de dados usando o GitHub Copilot.
Faça uma pergunta a Copilot para revelar o contexto ausente
Comece fazendo uma pergunta ao Copilot sobre seus dados em linguagem natural. Por exemplo, What was revenue for the last quarter of the year? se a empresa tiver datas de início diferentes para o ano fiscal e o ano civil ou se a receita exigir um cálculo que envolva várias tabelas, as tabelas ou colunas relevantes serão boas candidatas para uma instrução de banco de dados.
Definir a regra de negócios como uma instrução de banco de dados
No chat do Copilot, descreva a regra ou o esclarecimento que você deseja que Copilot lembre. Por exemplo, Add an instruction for the Finance.CompanyRevenue table to state that revenue is defined as SUM(NetAmount) excluding refunds recorded in Finance.Refunds.
Salvar a instrução no banco de dados
Depois que o Copilot gerar a sintaxe T-SQL para adicionar a instrução como uma propriedade estendida, você deverá manter essas informações como uma instrução de banco de dados. No modo Ask, o GitHub Copilot não pode executar consultas de modificação no banco de dados.
-- Created by GitHub Copilot in SSMS - review carefully before executing
EXECUTE sp_addextendedproperty
@name = N'AGENTS.md',
@value = N'Revenue is defined as SUM(NetAmount) excluding refunds recorded in Finance.Refunds. When calculating actual revenue, refunds must be subtracted from the Revenue column values.',
@level0type = N'SCHEMA',
@level0name = N'Finance',
@level1type = N'TABLE',
@level1name = N'CompanyRevenue';
Depois de adicionar a instrução ao banco de dados, o Copilot aplica automaticamente as informações a interações futuras.
Usar Copilot com a instrução aplicada
Faça ao Copilot a mesma pergunta ou uma pergunta relacionada novamente, What was revenue for the last quarter of the year? o Copilot agora usa a instrução salva para gerar resultados que se alinham à sua definição de receita de negócios, sem exigir que você reafirme a regra. Você também pode pedir ao Copilot Show me the query used to get this information. para confirmar o entendimento do Copilot sobre a instrução.
Mais exemplos
Há cenários infinitos em que as regras de negócios precisam ser aplicadas a um objeto de banco de dados, incluindo tabelas, colunas e procedimentos armazenados.
The dbo.Apts table stores information about patient appointmentsThe Status column in dbo.Apts encodes status as: 1 = Scheduled, 2 = Completed, 5 = Confirmed, 99 = CancelledThe DtCrtd column in dbo.Apts lists the date and time the appointment was created
Ao usar instruções de banco de dados com o Copilot, você também pode perguntar sobre as instruções que existem no momento.
Show me the database instructions for this databaseDoes this database have a constitution set?
Usar o GitHub Copilot para criar uma constituição de banco de dados
O GitHub Copilot no SSMS também dá suporte a uma constituição singular para seu banco de dados, que define a instrução de precedência mais alta para o banco de dados. A constituição pode incluir recomendações, diretrizes de codificação, políticas de retenção e muito mais.
Observação
Implementar uma estrutura de banco de dados aplica-se às conversas do GitHub Copilot para todos os usuários que utilizam o GitHub Copilot no SSMS. As recomendações e diretrizes se aplicam somente às conversas do GitHub Copilot.
EXECUTE sp_addextendedproperty
@name = N'CONSTITUTION.md',
@value = N'Any T-SQL in this database must comply with the organizational standards and guidelines outlined in this constitution document.
Queries that use SELECT * should not be used.';
Requirements
No momento, há suporte apenas para instruções de banco de dados como propriedades estendidas. Eles seguem o formato AGENTS.md para fornecer o contexto usado pelo GitHub Copilot. O nome da propriedade estendida do objeto deve ser AGENTS.md. Somente uma propriedade nomeada AGENTS.md pode existir para um objeto. Se uma instrução estiver incorreta, você poderá atualizá-la usando sp_updateextendedpropertyou excluí-la usando sp_dropextendedproperty. Não há nenhuma outra configuração necessária para que as instruções de banco de dados funcionem.