Tutorial: Use o editor Transact-SQL para criar objetos de banco de dados- Azure Data StudioAzure Data StudioTutorial: Use the Transact-SQL editor to create database objects - Azure Data StudioAzure Data Studio

Criando e executando consultas, procedimentos armazenados, scripts, etc. são as tarefas principais de profissionais de banco de dados.Creating and running queries, stored procedures, scripts, etc. are the core tasks of database professionals. Este tutorial demonstra os principais recursos no editor T-SQL para criar objetos de banco de dados.This tutorial demonstrates the key features in the T-SQL editor to create database objects.

Neste tutorial, você aprenderá a usar Azure Data StudioAzure Data Studio para:In this tutorial, you learn how to use Azure Data StudioAzure Data Studio to:

  • Objetos de banco de dados de pesquisaSearch database objects
  • Editar dados da tabelaEdit table data
  • Usar trechos de gravar rapidamente o T-SQLUse snippets to quickly write T-SQL
  • Exibir detalhes de objeto de banco de dados usando inspecionar definição e ir para definiçãoView database object details using Peek Definition and Go to Definition

PrerequisitesPrerequisites

Este tutorial requer o SQL Server ou banco de dados SQL TutorialDB.This tutorial requires the SQL Server or Azure SQL Database TutorialDB. Para criar o TutorialDB banco de dados, conclua um dos seguintes inícios rápidos:To create the TutorialDB database, complete one of the following quickstarts:

Localizar um objeto de banco de dados rapidamente e executar uma tarefa comumQuickly locate a database object and perform a common task

Azure Data StudioAzure Data Studio Fornece um widget de pesquisa para localizar rapidamente os objetos de banco de dados.provides a search widget to quickly find database objects. Lista de resultados fornece um menu de contexto para tarefas comuns de relevantes para o objeto selecionado, como editar dados para uma tabela.The results list provides a context menu for common tasks relevant to the selected object, such as Edit Data for a table.

  1. Abra a barra lateral de servidores (Ctrl + G), expanda bancos de dadose selecione TutorialDB.Open the SERVERS sidebar (Ctrl+G), expand Databases, and select TutorialDB.

  2. Abra o TutorialDB Dashboard clicando com o TutorialDB e selecionando gerenciar no menu de contexto:Open the TutorialDB Dashboard by right-clicking TutorialDB and selecting Manage from the context menu:

    menu de contexto - gerenciar

  3. No painel, clique com botão direito dbo. Os clientes (no widget de pesquisa) e selecione editar dados.On the dashboard, right-click dbo.Customers (in the search widget) and select Edit Data.

    Dica

    Para bancos de dados com muitos objetos, use o widget de pesquisa para localizar rapidamente a tabela, exibição, etc. que você está procurando.For databases with many objects, use the search widget to quickly locate the table, view, etc. that you're looking for.

    widget de pesquisa rápida

  4. Editar o E-mail coluna na primeira linha, digite *orlando0@adventure-works.com*e pressione Enter para salvar a alteração.Edit the Email column in the first row, type *orlando0@adventure-works.com*, and press Enter to save the change.

    Editar dados

Usar trechos de código T-SQL para criar procedimentos armazenadosUse T-SQL snippets to create stored procedures

Azure Data StudioAzure Data Studio fornece muitos trechos de código internos do T-SQL para rapidamente criar instruções.provides many built-in T-SQL snippets for quickly creating statements.

  1. Abra um novo editor de consulta pressionando Ctrl + N.Open a new query editor by pressing Ctrl+N.

  2. Tipo de sql no editor, seta para baixo até sqlCreateStoredProceduree pressione a guia chave (ou Enter) para carregar o criar armazenado trecho de código do procedimento.Type sql in the editor, arrow down to sqlCreateStoredProcedure, and press the Tab key (or Enter) to load the create stored procedure snippet.

    snippet-list

  3. O trecho de código do procedimento armazenado criar tem dois campos configurados para edição rápida, StoredProcedureName e SchemaName.The create stored procedure snippet has two fields set up for quick edit, StoredProcedureName and SchemaName. Selecione StoredProcedureName, mouse e selecione alteração de todas as ocorrências.Select StoredProcedureName, right-click, and select Change All Occurrences. Agora, digite getCustomer e todos os StoredProcedureName entradas de alteração para getCustomer.Now type getCustomer and all StoredProcedureName entries change to getCustomer.

    Trecho de código

  4. Alterar todas as ocorrências de SchemaName à dbo.Change all occurrences of SchemaName to dbo.

  5. O trecho de código contém parâmetros de espaço reservado e o corpo do texto que precisa ser atualizado.The snippet contains placeholder parameters and body text that needs updating. O EXECUTE instrução também contém o texto do espaço reservado porque não sabe quantos parâmetros terá o procedimento.The EXECUTE statement also contains placeholder text because it doesn't know how many parameters the procedure will have. Para este tutorial o trecho de código de atualização então, ele se parece com o código a seguir:For this tutorial update the snippet so it looks like the following code:

    -- Create a new stored procedure called 'getCustomer' in schema 'dbo'
    -- Drop the stored procedure if it already exists
    IF EXISTS (
    SELECT *
    FROM INFORMATION_SCHEMA.ROUTINES
    WHERE SPECIFIC_SCHEMA = N'dbo'
    AND SPECIFIC_NAME = N'getCustomer'
    )
    DROP PROCEDURE dbo.getCustomer
    GO
    -- Create the stored procedure in the specified schema
    CREATE PROCEDURE dbo.getCustomer
    @ID int
    -- add more stored procedure parameters here
    AS
    -- body of the stored procedure
    SELECT  c.CustomerId, 
    c.Name, 
    c.Location, 
    c.Email
    FROM dbo.Customers c
    WHERE c.CustomerId = @ID
    FOR JSON PATH
    
    GO
    -- example to execute the stored procedure we just created
    EXECUTE dbo.getCustomer 1
    GO
    
  6. Para criar o procedimento armazenado e dê a ele uma execução de teste, pressione F5.To create the stored procedure and give it a test run, press F5.

O procedimento armazenado foi criado e o resultados painel exibe o cliente retornado em JSON.The stored procedure is now created, and the RESULTS pane displays the returned customer in JSON. Para ver o JSON formatado, clique no registro retornado.To see formatted JSON, click the returned record.

Usar inspecionar definiçãoUse Peek Definition

Azure Data StudioAzure Data Studio fornece a capacidade de exibir uma definição de objetos usando o recurso de definição de espiada.provides the ability to view an objects definition using the peek definition feature. Esta seção cria um segundo procedimento armazenado e usa a definição de inspeção para ver quais colunas são em uma tabela para criar rapidamente o corpo do procedimento armazenado.This section creates a second stored procedure and uses peek definition to see what columns are in a table to quickly create the body of the stored procedure.

  1. Abra um novo editor pressionando Ctrl + N.Open a new editor by pressing Ctrl+N.

  2. Tipo de sql no editor, seta para baixo até sqlCreateStoredProceduree pressione a guia chave (ou Enter) para carregar o criar armazenado trecho de código do procedimento.Type sql in the editor, arrow down to sqlCreateStoredProcedure, and press the Tab key (or Enter) to load the create stored procedure snippet.

  3. Digite setCustomer para StoredProcedureName e dbo para SchemaNameType in setCustomer for StoredProcedureName and dbo for SchemaName

  4. Substitua o @param espaços reservados com a seguinte definição de parâmetro:Replace the @param placeholders with the following parameter definition:

    @json_val nvarchar(max)
    
  5. Substitua o corpo do procedimento armazenado com o código a seguir:Replace the body of the stored procedure with the following code:

    INSERT INTO dbo.Customers
    
  6. No inserir recém-adicionada, clique com botão direito da linha você dbo. Os clientes e selecione inspecionar definição.In the INSERT line you just added, right-click dbo.Customers and select Peek Definition.

    Inspecionar definição

  7. A definição da tabela é exibida para que você possa ver rapidamente quais colunas são na tabela.The table definition appears so you can quickly see what columns are in the table. Consulte a lista de colunas para concluir facilmente as instruções para o procedimento armazenado.Refer to the column list to easily complete the statements for your stored procedure. Concluir a criação da instrução INSERT que você adicionou anteriormente para concluir o corpo do procedimento armazenado e fechar uma janela Inspecionar definição:Finish creating the INSERT statement you added previously to complete the body of the stored procedure, and close the peek definition window:

    INSERT INTO dbo.Customers (CustomerId, Name, Location, Email)
        SELECT CustomerId, Name, Location, Email
        FROM OPENJSON (@json_val)
        WITH(   CustomerId int, 
                Name nvarchar(50), 
                Location nvarchar(50), 
                Email nvarchar(50)
     )
    
  8. Excluir (ou comente) a EXECUTE comando na parte inferior da consulta.Delete (or comment out) the EXECUTE command at the bottom of the query.

  9. A instrução inteira deve parecer com o código a seguir:The entire statement should look like the following code:

    -- Create a new stored procedure called 'setCustomer' in schema 'dbo'
    -- Drop the stored procedure if it already exists
    IF EXISTS (
    SELECT *
        FROM INFORMATION_SCHEMA.ROUTINES
        WHERE SPECIFIC_SCHEMA = N'dbo'
        AND SPECIFIC_NAME = N'setCustomer'
    )
    DROP PROCEDURE dbo.setCustomer
    GO
    -- Create the stored procedure in the specified schema
    CREATE PROCEDURE dbo.setCustomer
        @json_val nvarchar(max) 
    AS
        -- body of the stored procedure
        INSERT INTO dbo.Customers (CustomerId, Name, Location, Email)
        SELECT CustomerId, Name, Location, Email
        FROM OPENJSON (@json_val)
        WITH(   CustomerId int, 
                Name nvarchar(50), 
                Location nvarchar(50), 
                Email nvarchar(50)
        )
    GO
    
  10. Para criar o setCustomer procedimento armazenado, pressione F5.To create the setCustomer stored procedure, press F5.

Use salvar os resultados da consulta como JSON para testar o procedimento armazenado de setCustomerUse save query results as JSON to test the setCustomer stored procedure

O setCustomer procedimento armazenado criado na seção anterior requer JSON dados passados para o *@json_val* parâmetro.The setCustomer stored procedure created in the previous section requires JSON data be passed into the *@json_val* parameter. Esta seção mostra como obter um pouco corretamente formatado de JSON para passar para o parâmetro para que você possa testar o procedimento armazenado.This section shows how to get a properly formatted bit of JSON to pass into the parameter so you can test the stored procedure.

  1. No servidores barra lateral com o botão direito do dbo. Os clientes tabela e clique em selecionar 1000 linhas SUPERIORES.In the SERVERS sidebar right-click the dbo.Customers table and click SELECT TOP 1000 Rows.

  2. Selecione a primeira linha na exibição dos resultados, verifique se toda a linha está selecionada (clique no número 1 na coluna mais à esquerda) e selecione Salvar como JSON.Select the first row in the results view, make sure the entire row is selected (click the number 1 in the left-most column), and select Save as JSON.

  3. Alterar a pasta para um local que você vai se lembrar para que você pode excluir o arquivo mais tarde (para a área de trabalho de exemplo) e clique em salvar.Change the folder to a location you'll remember so you can delete the file later (for example desktop) and click Save. O JSON formatado arquivo é aberto.The JSON formatted file opens.

    Salvar como JSON

  4. Selecione os dados JSON no editor e copiá-lo.Select the JSON data in the editor and copy it.

  5. Abra um novo editor pressionando Ctrl + N.Open a new editor by pressing Ctrl+N.

  6. As etapas anteriores mostram como você pode obter facilmente os dados formatados corretamente para completar a chamada para o setCustomer procedimento.The previous steps show how you can easily get the properly formatted data to complete the call to the setCustomer procedure. Você pode ver o código a seguir usa o mesmo formato JSON com novos detalhes do cliente para que possamos testar o setCustomer procedimento.You can see the following code uses the same JSON format with new customer details so we can test the setCustomer procedure. A instrução inclui a sintaxe para declarar o parâmetro e executar get novo e conjunto de procedimentos.The statement includes syntax to declare the parameter and run the new get and set procedures. Você pode colar os dados copiados da seção anterior e editá-lo, portanto, é o mesmo que o exemplo a seguir ou simplesmente colar a instrução a seguir no editor de consultas.You can paste the copied data from the previous section and edit it so it is the same as the following example, or simply paste the following statement into the query editor.

    -- example to execute the stored procedure we just created
    declare @json nvarchar(max) =
    N'[
        {
            "CustomerId": 5,
            "Name": "Lucy",
            "Location": "Canada",
            "Email": "lucy0@adventure-works.com"
        }
    ]'
    
    EXECUTE dbo.setCustomer @json_val = @json
    GO
    
    EXECUTE dbo.getCustomer @ID = 5
    
  7. Execute o script pressionando F5.Execute the script by pressing F5. O script insere um novo cliente e retorna as novas informações do cliente no formato JSON.The script inserts a new customer and returns the new customer's information in JSON format. Clique no resultado para abrir uma exibição formatada.Click the result to open a formatted view.

    resultado do teste

Próximas etapasNext steps

Neste tutorial, você aprendeu como:In this tutorial, you learned how to:

  • Objetos de esquema de pesquisa rápidaQuick search schema objects
  • Editar dados da tabelaEdit table data
  • Escrevendo o script T-SQL usando trechos de códigoWriting T-SQL script using snippets
  • Saiba mais sobre os detalhes do objeto de banco de dados usando inspecionar definição e ir para definiçãoLearn about database object details using Peek Definition and Go to Definition

Para saber como habilitar a cinco consultas mais lentas widget, conclua o próximo tutorial:To learn how to enable the five slowest queries widget, complete the next tutorial: