Partilhar via


Adicionar Transact-SQL trechos

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada SQL do Azure do Azure Synapse AnalyticsAnalytics Platform System (PDW)

Você pode adicionar seus próprios trechos de código Transact-SQL ao conjunto de trechos predefinidos incluídos no SQL Server.

Criar um arquivo de trecho de Transact-SQL

A primeira parte da criação de um trecho de código Transact-SQL é criar um arquivo XML com o texto do trecho de código. O arquivo deve ter uma .snippet extensão de arquivo e atender aos requisitos do esquema de trechos de código. Defina a linguagem do trecho como SQL.

Você pode usar os trechos predefinidos fornecidos com o SQL Server como exemplos. Para localizar os trechos predefinidos, abra o SQL Server Management Studio, selecione o menu Ferramentas e selecione Gerenciador de trechos de código. Selecione SQL na caixa de listagem Idioma , o caminho para os trechos de Transact-SQL é exibido na caixa Local .

Registrar o trecho de código

Depois de criar o arquivo de trecho, use o Gerenciador de Trechos de Código para registrar o trecho com o SQL Server Management Studio. Você pode adicionar uma pasta contendo vários trechos ou importar trechos individuais para a pasta Meus trechos de código .

Procedimentos

Adicionar uma pasta de snippet

  1. Abra o SQL Server Management Studio.
  2. Selecione o menu Ferramentas e selecione Gerenciador de trechos de código.
  3. Selecione o botão Adicionar .
  4. Navegue até a pasta que contém seus trechos de código e selecione o botão Selecionar pasta .

Importar um trecho

  1. Abra o SQL Server Management Studio.
  2. Selecione o menu Ferramentas e selecione Gerenciador de trechos de código.
  3. Selecione o botão Importar .
  4. Navegue até a pasta que contém o trecho, selecione o .snippet arquivo e selecione o botão Abrir .

Exemplos

O exemplo a seguir cria um TRY...CATCH trecho surround-with e o importa para o SQL Server Management Studio.

  1. Cole o código a seguir no bloco de notas e salve como um arquivo chamado TryCatch.snippet.

    <?xml version="1.0" encoding="utf-8" ?>
    <CodeSnippets
        xmlns="http://schemas.microsoft.com/VisualStudio/2005/CodeSnippet">
        <_locDefinition
            xmlns="urn:locstudio">
            <_locDefault _loc="locNone" />
            <_locTag _loc="locData">Title</_locTag>
            <_locTag _loc="locData">Description</_locTag>
            <_locTag _loc="locData">Author</_locTag>
            <_locTag _loc="locData">ToolTip</_locTag>
            <_locTag _loc="locData">Default</_locTag>
        </_locDefinition>
        <CodeSnippet Format="1.0.0">
            <Header>
                <Title>TryCatch</Title>
                <Shortcut></Shortcut>
                <Description>Example Snippet for Try-Catch.</Description>
                <Author>SQL Server Documentation Example</Author>
                <SnippetTypes>
                    <SnippetType>SurroundsWith</SnippetType>
                </SnippetTypes>
            </Header>
            <Snippet>
                <Declarations>
                    <Literal>
                        <ID>CatchCode</ID>
                        <ToolTip>Code to handle the caught error</ToolTip>
                        <Default>CatchCode</Default>
                    </Literal>
                </Declarations>
                <Code Language="SQL">
                    <![CDATA[
       BEGIN TRY
    
       $selected$ $end$
    
       END TRY
       BEGIN CATCH
    
       $CatchCode$
    
       END CATCH;
       ]]>
                </Code>
            </Snippet>
        </CodeSnippet>
    </CodeSnippets>
    
  2. Abra o SQL Server Management Studio.

  3. Selecione o menu Ferramentas e selecione Gerenciador de trechos de código.

  4. Selecione o botão Importar .

  5. Navegue até a pasta que contém TryCatch.snippeto , selecione o TryCatch.snippet arquivo e selecione o botão Abrir . Agora você deve ter um TryCatch snippet na pasta My Code Snippets .