Compartilhar via

Início Rápido: Usar comandos de barra do GitHub Copilot

Os comandos de barra do GitHub Copilot fornecem uma maneira rápida e detectável de interagir com seus bancos de dados do SQL Server diretamente do chat do GitHub Copilot no Visual Studio Code. Esses comandos estão disponíveis por meio da integração da extensão MSSQL com o GitHub Copilot, usando o participante do @mssql chat. Ao digitar / na entrada de chat, você pode ver uma lista de comandos com suporte que aceleram fluxos de trabalho comuns, como conectar, alternar bancos de dados, explorar esquemas e executar consultas.

O que são comandos de barra?

Os comandos com barra fornecem uma maneira rápida de inserir prompts estruturados diretamente no chat do GitHub Copilot. Eles são projetados para velocidade e capacidade de descoberta, ajudando você a executar tarefas comuns de banco de dados sem escrever consultas de linguagem natural completas.

Por exemplo, você pode digitar:

@mssql /getConnectionDetails

Captura de tela do uso de um exemplo de comando de barra no chat do GitHub Copilot.

Observação

Ao contrário das ferramentas no modo agente, os comandos de barra funcionam como atalhos: inserem prompts estruturados no chat, para que você não precise criar consultas completas em linguagem natural. Alguns comandos são executados instantaneamente (como alternar bancos de dados), enquanto outros exigem entrada de acompanhamento (como executar ou explicar uma consulta).

Referência de comandos de barra MSSQL

Esta seção fornece uma referência detalhada para os comandos de barra específicos do SQL disponíveis no GitHub Copilot. Esses comandos são contribuidos pelo participante do chat do MSSQL e exibidos diretamente na interface de chat do GitHub Copilot.

Importante

Todos os comandos de barra exigem um editor ativo conectado a um banco de dados para funcionar. Se nenhuma conexão estiver ativa, os comandos não serão executados.

Captura de tela do primeiro conjunto de opções de comando de barra da extensão MSSQL no chat do GitHub Copilot.

Captura de tela do segundo conjunto de opções de comando de barra da extensão MSSQL no chat do GitHub Copilot.

Gerenciamento de conexões

Esses comandos permitem estabelecer, alternar ou inspecionar conexões. Eles não exigem entrada extra: selecionar um abre o painel de conexão ou executa a ação diretamente.

Command Description
/connect Abre o painel de conexão para estabelecer uma nova conexão de banco de dados.
/disconnect Encerra a sessão de conexão ativa atual.
/changeDatabase Abre o painel de conexão para alternar para um banco de dados diferente no servidor atual.
/getConnectionDetails Exibe detalhes da conexão atual, como servidor, banco de dados e tipo de autenticação.

Exemplos

As frases a seguir podem ser usadas para interagir com o GitHub Copilot.

@mssql /connect
@mssql /disconnect
@mssql /changeDatabase
@mssql /getConnectionDetails

Veja como esses comandos estão em ação para obter detalhes da conexão:

Captura de tela do uso de um exemplo de comando de barra no chat do GitHub Copilot.

Como funciona a lógica de conexão

Os comandos de barra para o gerenciamento de conexões atuam como atalhos verdadeiros. Ao contrário das ferramentas do Modo agente que tentam resolver conexões automaticamente, esses comandos abrem a caixa de diálogo de conexão de extensão MSSQL dentro do Visual Studio Code. Em seguida, o usuário deve interagir com a caixa de diálogo para selecionar ou criar uma conexão.

Quando você invoca /connect ou /changeDatabase:

  1. O GitHub Copilot coloca o comando no chat.
  2. A extensão MSSQL abre a caixa de diálogo de conexão padrão.
  3. Você escolhe um perfil existente ou cria um novo.
  4. Uma vez confirmada, a conexão é estabelecida ou alternada.

Quando você invoca /disconnect:

  • A extensão MSSQL encerra a sessão ativa imediatamente.

Quando você invoca /getConnectionDetails:

  • A extensão MSSQL apresenta os detalhes atuais da conexão no chat, sem a necessidade de mais entradas.

Veja como esses comandos ficam em ação, para se conectar ou alterar bancos de dados:

Captura de tela da animação mostrando o comando de barra /changeDatabase para alternar bancos de dados da interface de chat.

Esse design mantém a experiência consistente com a interface do usuário da extensão MSSQL: o comando de barra acelera o acesso, enquanto a caixa de diálogo garante que você possa revisar e confirmar os detalhes da conexão de forma interativa.

Execução e desempenho da consulta

Esses comandos exigem entrada posterior. Depois de selecionar um comando, forneça a instrução SQL ou o objeto que você deseja analisar.

Command Description
/runQuery Executa uma consulta SQL no banco de dados conectado e mostra os resultados no chat.
/explain Fornece uma explicação em linguagem natural do código SQL ou consultas.
/fix Detecta e corrige problemas de sintaxe ou restrições ausentes no código SQL.
/optimize Analisa o desempenho da consulta e sugere melhorias (indexação, reestruturação).

Exemplos

As frases a seguir podem ser usadas para interagir com o GitHub Copilot.

@mssql /runQuery SELECT TOP 10 * FROM Orders
@mssql /explain SELECT COUNT(*) FROM Customers
@mssql /fix any errors in my query: SELECT * FROM Orders WHERE OrderDate > '2025-01-01'
@mssql /optimize SELECT * FROM Products WHERE Price > 100

Veja como esses comandos ficam em ação para executar ou otimizar uma consulta:

Captura de tela mostrando o comando de barra /runQuery com SQL para pokémons avançados.

Captura de tela mostrando os resultados do comando de barra /runQuery para os principais Pokémon poderosos.

Captura de tela mostrando a sugestão de comando de barra /optimize para uma consulta sargable.

Captura de tela mostrando as sugestões de otimização detalhada do comando /optimize slash e a criação de índice.

Exploração de esquema e gerenciamento de objetos

Esses comandos listam ou visualizam objetos de esquema no banco de dados conectado.

Command Description
/showSchema Exibe um diagrama de alto nível do esquema de banco de dados (tabelas, relações, chaves).
/showDefinition Mostra a definição de uma tabela, exibição, função ou procedimento específico.
/listServers Lista todos os perfis de conexão salvos do SQL Server.
/listDatabases Lista todos os bancos de dados no servidor atual.
/listSchemas Lista todos os esquemas no banco de dados atual.
/listTables Lista todas as tabelas no banco de dados atual.
/listViews Lista todas as exibições no banco de dados atual.
/listFunctions Lista todas as funções no banco de dados atual.
/listProcedures Lista todos os procedimentos armazenados no banco de dados atual.

Exemplos

As frases a seguir podem ser usadas para interagir com o GitHub Copilot.

@mssql /showSchema
@mssql /showDefinition Orders
@mssql /listDatabases
@mssql /listTables
@mssql /listViews
@mssql /listProcedures

Veja como esses comandos estão em ação para explorar esquemas e objetos de lista:

Captura de tela do uso do comando de barra /listSchemas no chat do GitHub Copilot.

Captura de tela do uso do comando de barra /listTables no chat do GitHub Copilot.

Principais diferenças do Modo do Agente

  • Comandos Slash: Insira comandos estruturados no chat. Alguns agem imediatamente (como o gerenciamento de conexões), outros exigem entrada do usuário. Eles foram projetados para acesso rápido e capacidade de descoberta.

  • Modo de Agente: usa ferramentas com contribuição de extensão que executam ações diretamente, com caixas de diálogo de confirmação para execução segura. O Modo de Agente dá suporte a fluxos de trabalho mais avançados e complexos dentro do ambiente de desenvolvimento do SQL.

Ambas as abordagens podem ser usadas em conjunto; os comandos de barra aceleram a entrada do prompt, enquanto o Modo agente executa ações seguras e confirmáveis.

Conteúdo relacionado

  • Last updated on