Partilhar 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 detetá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 através da integração da extensão MSSQL com o GitHub Copilot, usando o participante do @mssql chat. Ao digitar / a entrada de bate-papo, você pode ver uma lista de comandos suportados 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 de 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 completas em linguagem natural.

Por exemplo, você pode digitar:

@mssql /getConnectionDetails

Captura de tela mostrando o uso de um exemplo de comando de barra no bate-papo do GitHub Copilot.

Observação

Ao contrário das ferramentas em Modo de Agente, os comandos de barra funcionam como atalhos: inserem prompts estruturados no bate-papo, eliminando a necessidade de 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 contribuídos pelo participante do bate-papo MSSQL e aparecem diretamente na interface de bate-papo do GitHub Copilot.

Importante

Todos os comandos de barra requerem 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.

Gestão de ligaçõ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.

Examples

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 aparecem em ação, para obter detalhes da conexão:

Captura de tela mostrando o uso de um exemplo de comando de barra no bate-papo do GitHub Copilot.

Como funciona a lógica de conexão

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

Quando invoca /connect ou /changeDatabase:

  1. O GitHub Copilot insere 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 comutada.

Quando invoca /disconnect:

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

Quando invoca /getConnectionDetails:

  • A extensão MSSQL exibe os detalhes da conexão atual no chat, sem exigir mais entradas.

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

Captura de tela da animação mostrando o comando /changeDatabase slash 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 slash acelera o acesso, enquanto a caixa de diálogo garante que você possa revisar e confirmar os detalhes da conexão interativamente.

Execução e desempenho de consultas

Esses comandos exigem entrada de acompanhamento. 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 bate-papo.
/explain Fornece uma explicação em linguagem natural do código SQL ou consultas.
/fix Deteta 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).

Examples

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 aparecem em ação, para executar ou otimizar uma consulta:

Captura de tela mostrando o comando /runQuery slash com SQL para Pokémon poderosos superiores.

Captura de ecrã a mostrar os resultados do comando de barra /runQuery para os Pokémon mais poderosos.

Captura de tela mostrando a sugestão de comando /otimize slash para uma consulta sargable.

Captura de tela mostrando o comando /otimize slash sugestões detalhadas de otimização e criação de índice.

Exploração de esquemas 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 do 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 do SQL Server salvos.
/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 vistas na base 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.

Examples

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 aparecem em ação, para explorar esquemas e listar objetos:

Captura de tela mostrando o uso do comando /listSchemas slash no chat do GitHub Copilot.

Captura de tela mostrando o uso do comando /listTables slash no chat do GitHub Copilot.

Principais diferenças do Modo de Agente

  • Comandos de barra: insira prompts estruturados no chat. Alguns agem imediatamente (como o gerenciamento de conexões), outros exigem a entrada do usuário. Eles são projetados para acesso rápido e capacidade de descoberta.

  • Modo de agente: Usa ferramentas de extensão que executam ações diretamente, com caixas de diálogo de confirmação para execução segura. O Modo de Agente suporta fluxos de trabalho mais ricos e complexos dentro do seu ambiente de desenvolvimento SQL.

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