分享方式:


新增 Transact-SQL 程式碼片段

適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

您可以將自己的 Transact-SQL 程式碼片段新增至 SQL Server 中包含的預先定義程式碼片段集合。

建立 Transact-SQL 程式碼片段檔案

建立 Transact-SQL 程式碼片段的第一部分是使用您自己的程式碼片段文字建立 XML 檔案。 此檔案必須有 .snippet 副檔名,且必須符合 程式碼片段結構描述參考的需求。 將程式碼片段語言設定為 SQL。

您可以使用 SQL Server 所隨附的預先定義程式碼片段當做範例。 若要尋找預先定義的程式碼片段,請開啟 SQL Server Management Studio,選取 [工具] 功能表,然後按一下 [程式碼片段管理員]。 在 [語言] 清單方塊中選取 SQL,Transact-SQL 程式碼片段的路徑就會顯示在 [位置] 方塊中。

註冊程式碼片段

在建立程式碼片段檔案之後,請使用程式碼片段管理員,向 SQL Server Management Studio 註冊程式碼片段。 您可以加入包含多個程式碼片段的資料夾,或是將個別程式碼片段匯入到 [My Code 程式碼片段] 資料夾。

程序

加入程式碼片段資料夾

  1. 開啟 SQL Server Management Studio。

  2. 選取 [工具] 功能表,然後按一下 [程式碼片段管理員]

  3. 按一下 [新增] 按鈕。

  4. 導覽至包含程式碼片段的資料夾,然後按一下 [選取資料夾] 按鈕。

匯入程式碼片段

  1. 開啟 SQL Server Management Studio。

  2. 選取 [工具] 功能表,然後按一下 [程式碼片段管理員]

  3. 按一下 [匯入] 按鈕。

  4. 導覽至包含程式碼片段的資料夾,然後按一下 .snippet 檔案,再按一下 [開啟] 按鈕。

範例

下列範例會建立 TRY-CATCH 範圍陳述式程式碼片段,並將其匯入至 SQL Server Management Studio。

  1. 將下列程式碼貼到 [記事本],然後將檔案儲存為 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 Books Online 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. 開啟 SQL Server Management Studio。

  3. 選取 [工具] 功能表,然後按一下 [程式碼片段管理員]

  4. 按一下 [匯入] 按鈕。

  5. 導覽至包含 TryCatch.snippet 的資料夾,然後按一下 TryCatch.snippet 檔案,再按一下 [開啟] 按鈕。 您應該會在 My Code Snippets 資料夾看到 TryCatch 程式碼片段。

另請參閱

插入範圍陳述式 Transact-SQL 程式碼片段