Início Rápido: Criar um aplicativo de API de Tabela com Node.js e Azure Cosmos DBQuickstart: Build a Table API app with Node.js and Azure Cosmos DB

Este guia de início rápido mostra como usar o Node.js e a API de Tabela do Azure Cosmos DB para compilar um aplicativo clonando um exemplo do GitHub.This quickstart shows how to use Node.js and the Azure Cosmos DB Table API to build an app by cloning an example from GitHub. Este guia de início rápido também mostra como criar uma conta do Azure Cosmos DB e como usar o Data Explorer para criar tabelas e entidades no Portal do Azure baseado na Web.This quickstart also shows you how to create an Azure Cosmos DB account and how to use Data Explorer to create tables and entities in the web-based Azure portal.

O Azure Cosmos DB é o serviço de banco de dados multimodelo distribuído globalmente da Microsoft.Azure Cosmos DB is Microsoft’s globally distributed multi-model database service. É possível criar e consultar rapidamente documentos, chave/valor, coluna larga e bancos de dados do gráfico. Todos se beneficiam de recursos de escala horizontal e distribuição global no núcleo do Azure Cosmos DB.You can quickly create and query document, key/value, wide-column, and graph databases, all of which benefit from the global distribution and horizontal scale capabilities at the core of Azure Cosmos DB.

Pré-requisitosPrerequisites

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.If you don't have an Azure subscription, create a free account before you begin.

Você pode Experimentar o Azure Cosmos DB gratuitamente sem uma assinatura do Azure, gratuitamente e sem compromisso.You can Try Azure Cosmos DB for free without an Azure subscription, free of charge and commitments. Ou, você pode usar o Emulador do Azure Cosmos DB com um URI de https://localhost:8081.Or, you can use the Azure Cosmos DB Emulator with a URI of https://localhost:8081. Quanto à chave a ser usada com o emulador, confira Autenticação de solicitações.For the key to use with the emulator, see Authenticating requests.

Além disso:In addition:

Criar uma conta de banco de dadosCreate a database account

Importante

Você precisa criar uma nova conta de API de tabela para trabalhar com os SDKs de API de tabela disponíveis.You need to create a new Table API account to work with the generally available Table API SDKs. Não há suporte para contas de API de tabela criadas durante a versão prévia pelos SDKs disponíveis.Table API accounts created during preview are not supported by the generally available SDKs.

  1. Em uma nova janela do navegador, entre no Portal do Azure.In a new browser window, sign in to the Azure portal.

  2. No painel de navegação esquerdo, selecione Criar um recurso.In the left navigation pane, select Create a resource. Selecione Bancos de dados e, em seguida, selecione Azure Cosmos DB.Select Databases and then select Azure Cosmos DB.

    Captura de tela do portal do Azure, realçando Mais Serviços e Azure Cosmos DB

  3. Na página Criar Conta do Azure Cosmos DB, insira as configurações da nova conta do Azure Cosmos DB:On the Create Azure Cosmos DB Account page, enter the settings for the new Azure Cosmos DB account:

    ConfiguraçãoSetting ValorValue DESCRIÇÃODescription
    AssinaturaSubscription Sua assinaturaYour subscription Selecione a assinatura do Azure que você deseja usar para essa conta do Azure Cosmos DB.Select the Azure subscription that you want to use for this Azure Cosmos DB account.
    Grupo de recursosResource Group Criar NovoCreate new

    Em seguida, insira o mesmo nome exclusivo fornecido na IDThen enter the same unique name as provided in ID
    Selecione Criar novo.Select Create new. Em seguida, insira um novo nome de grupo de recursos para a conta.Then enter a new resource group name for your account. Para simplificar, use um nome igual à sua ID.For simplicity, use the same name as your ID.
    Nome da contaAccount Name Insira um nome exclusivoEnter a unique name Insira um nome exclusivo para identificar a conta do Azure Cosmos DB.Enter a unique name to identify your Azure Cosmos DB account.

    A ID deve conter apenas letras minúsculas, números e o caractere de hífen (-).The ID can use only lowercase letters, numbers, and the hyphen (-) character. Deve ter entre 3 e 31 caracteres.It must be between 3 and 31 characters long.
    APIAPI tabela do AzureAzure Table A API determina o tipo de conta a ser criada.The API determines the type of account to create. O Azure Cosmos DB fornece cinco APIs: Core(SQL) para bancos de dados de documentos, Gremlin para o bancos de dados de grafos, MongoDB para bancos de dados de documentos, Tabela do Azure e Cassandra.Azure Cosmos DB provides five APIs: Core(SQL) for document databases, Gremlin for graph databases, MongoDB for document databases, Azure Table, and Cassandra. No momento, você deve criar uma conta separada para cada API.Currently, you must create a separate account for each API.

    Selecione Tabela do Azure porque neste início rápido você está criando uma tabela que funciona com a API de Tabela.Select Azure Table because in this quickstart you're creating a table that works with the Table API.

    Saiba mais sobre a API de Tabela.Learn more about the Table API.
    Local padrãoLocation Selecione a região mais próxima de seus usuáriosSelect the region closest to your users Selecione uma localização geográfica para hospedar a sua conta do Azure Cosmos DB.Select a geographic location to host your Azure Cosmos DB account. Use a localização mais próxima dos usuários para fornecer a eles acesso mais rápido aos dados.Use the location that's closest to your users to give them the fastest access to data.

    Você pode manter as opções Replicação Geográfica e Gravações de Várias Regiões com os valores padrão (Desabilitar) para evitar encargos de RU adicionais.You can leave the Geo-Redundancy and Multi-region Writes options at their default values (Disable) to avoid additional RU charges. Você pode ignorar as seções Rede e Marcas.You can skip the Network and Tags sections.

  4. Selecione Revisar + Criar.Select Review+Create. Após a concluir a validação, selecione Criar para criar a conta.After the validation is complete, select Create to create the account.

    A página da nova conta do Azure Cosmos DB

  5. São necessários alguns minutos para criar a conta.It takes a few minutes to create the account. Um mensagem informando A implantação está em andamento será exibida.You'll see a message that states Your deployment is underway. Aguarde a conclusão da implantação e selecione Ir para o recurso.Wait for the deployment to finish and then select Go to resource.

    O painel de notificações do portal do Azure

Adicionar uma tabelaAdd a table

Agora, você pode usar a ferramenta Data Explorer no Portal do Azure para criar um banco de dados e uma tabela.You can now use the Data Explorer tool in the Azure portal to create a database and table.

  1. Selecione Data Explorer > Nova Tabela.Select Data Explorer > New Table.

    A área Adicionar Tabela é exibida à direita, talvez seja necessário rolar para a direita para vê-la.The Add Table area is displayed on the far right, you may need to scroll right to see it.

    Data Explorer no Portal do Azure

  2. Na página Adicionar Tabela, insira as configurações da nova tabela.In the Add Table page, enter the settings for the new table.

    ConfiguraçãoSetting Valor sugeridoSuggested value DESCRIÇÃODescription
    Id da TabelaTable Id tabela de exemplosample-table A ID da nova tabela.The ID for your new table. Os nomes de tabela possuem os mesmos requisitos de caractere que os ids de banco de dados.Table names have the same character requirements as database ids. Os nomes de banco de dados devem ter entre um e 255 caracteres e não podem conter / \ # ? nem espaços à direita.Database names must be between 1 and 255 characters, and cannot contain / \ # ? or a trailing space.
    ProdutividadeThroughput 400 RUs400 RUs Altere a taxa de transferência para 400 unidades de solicitação por segundo (RU/s).Change the throughput to 400 request units per second (RU/s). Se quiser reduzir a latência, você poderá escalar verticalmente a taxa de transferência mais tarde.If you want to reduce latency, you can scale up the throughput later.
  3. Selecione OK.Select OK.

  4. O Data Explorer exibe o novo banco de dados e a tabela.Data Explorer displays the new database and table.

    O Data Explorer do Portal do Azure, mostrando o novo banco de dados e a coleção

Adicionar dados de exemploAdd sample data

Agora é possível adicionar dados à sua nova tabela usando o Data Explorer.You can now add data to your new table using Data Explorer.

  1. No Data Explorer, expanda sample-table, selecione Entidades e selecione Adicionar Entidade.In Data Explorer, expand sample-table, select Entities, and then select Add Entity.

    Criar novas entidades no Data Explorer no portal do Azure

  2. Agora, adicione dados às caixas de valor PartitionKey e RowKey e selecione Adicionar Entidade.Now add data to the PartitionKey value box and RowKey value box, and select Add Entity.

    Definir a chave de partição e a chave de linha para uma nova entidade

    Agora, é possível adicionar mais entidades à tabela, editar as entidades ou consultar os dados no Data Explorer.You can now add more entities to your table, edit your entities, or query your data in Data Explorer. Por meio do Data Explorer, também é possível dimensionar a taxa de transferência e adicionar procedimentos armazenados, funções definidas pelo usuário e gatilhos à tabela.Data Explorer is also where you can scale your throughput and add stored procedures, user-defined functions, and triggers to your table.

Clonar o aplicativo de exemploClone the sample application

Agora, clonaremos um aplicativo de Tabela do GitHub, definiremos a cadeia de conexão e o executaremos.Now let's clone a Table app from GitHub, set the connection string, and run it. Você verá como é fácil trabalhar usando dados de forma programática.You'll see how easy it is to work with data programmatically.

  1. Abra um prompt de comando, crie uma nova pasta chamada exemplos de git e feche o prompt de comando.Open a command prompt, create a new folder named git-samples, then close the command prompt.

    md "C:\git-samples"
    
  2. Abra uma janela de terminal de git, como git bash, e use o comando cd para alterar para a nova pasta para instalar o aplicativo de exemplo.Open a git terminal window, such as git bash, and use the cd command to change to the new folder to install the sample app.

    cd "C:\git-samples"
    
  3. Execute o comando a seguir para clonar o repositório de exemplo.Run the following command to clone the sample repository. Este comando cria uma cópia do aplicativo de exemplo no seu computador.This command creates a copy of the sample app on your computer.

    git clone https://github.com/Azure-Samples/storage-table-node-getting-started.git
    

Atualizar sua cadeia de conexãoUpdate your connection string

Agora, volte ao portal do Azure para obter informações sobre a cadeia de conexão e copiá-las para o aplicativo.Now go back to the Azure portal to get your connection string information and copy it into the app. Isso permite que seu aplicativo se comunique com o banco de dados hospedado.This enables your app to communicate with your hosted database.

  1. No Portal do Azure, clique em Cadeia de Conexão.In the Azure portal, click Connection String.

    Exibir e copiar as informações necessárias da cadeia de conexão do painel da Cadeia de Conexão

  2. Copie a CADEIA DE CONEXÃO PRIMÁRIA usando o botão de cópia do lado direito.Copy the PRIMARY CONNECTION STRING using the copy button on the right-side.

  3. Abra o arquivo app.config e cole o valor em connectionString na linha três.Open the app.config file, and paste the value into the connectionString on line three.

    Importante

    Se o ponto de extremidade usa documents.azure.com, isso significa que você tem uma conta de versão prévia, e você precisa criar um nova conta de API de tabela para trabalhar com o SDK de API de tabela geralmente disponível.If your Endpoint uses documents.azure.com, that means you have a preview account, and you need to create a new Table API account to work with the generally available Table API SDK.

  4. Salve o arquivo app.config.Save the app.config file.

Agora, você atualizou o aplicativo com todas as informações necessárias para se comunicar com o Azure Cosmos DB.You've now updated your app with all the info it needs to communicate with Azure Cosmos DB.

Execute o aplicativoRun the app

  1. Na janela do terminal git, cd para a pasta storage-table-java-getting-started.In the git terminal window, cd to the storage-table-java-getting-started folder.

    cd "C:\git-samples\storage-table-node-getting-started"
    
  2. Execute o seguinte comando para instalar os módulos azure, [node-uuid], [nconf] e [async] localmente, bem como para salvar uma entrada para eles no arquivo package.jsonRun the following command to install the [azure], [node-uuid], [nconf] and [async] modules locally as well as to save an entry for them to the package.json file

    npm install azure-storage node-uuid async nconf --save
    
  3. Na janela do terminal git, execute os comandos a seguir para executar e iniciar o aplicativo de Nó.In the git terminal window, run the following commands to run start the Node application.

    node ./tableSample.js 
    

    A janela de console exibe os dados da tabela sendo adicionados ao novo banco de dados de tabela no Azure Cosmos DB.The console window displays the table data being added to the new table database in Azure Cosmos DB.

    Agora, é possível voltar ao Data Explorer e ver a consulta, modificar e trabalhar com esses novos dados.You can now go back to Data Explorer and see query, modify, and work with this new data.

Examinar SLAs no Portal do AzureReview SLAs in the Azure portal

O portal do Azure monitora a taxa de transferência, armazenamento, disponibilidade, latência e consistência da conta do Cosmos DB.The Azure portal monitors your Cosmos DB account throughput, storage, availability, latency, and consistency. Gráficos de métricas associados a um SLA (Contrato de Nível de Serviço) do Azure Cosmos DB mostram o valor do SLA em comparação com o desempenho real.Charts for metrics associated with an Azure Cosmos DB Service Level Agreement (SLA) show the SLA value compared to actual performance. Esse conjunto de métricas torna o monitoramento dos SLAs transparente.This suite of metrics makes monitoring your SLAs transparent.

Para examinar as métricas e os SLAs:To review metrics and SLAs:

  1. Selecione Métricas no menu de navegação da sua conta do Cosmos DB.Select Metrics in your Cosmos DB account's navigation menu.

  2. Selecione uma guia, tal como Latência, e selecione um período à direita.Select a tab such as Latency, and select a timeframe on the right. Comparar as linhas Real e SLA dos gráficos.Compare the Actual and SLA lines on the charts.

    Pacote de métricas do Azure Cosmos DB

  3. Examine as métricas nas outras guias.Review the metrics on the other tabs.

Limpar recursosClean up resources

Quando você concluir seu aplicativo Web e a conta do Azure Cosmos DB, poderá excluir os recursos do Azure criados para não incorrer em mais cobranças.When you're done with your web app and Azure Cosmos DB account, you can delete the Azure resources you created so you don't incur more charges. Para excluir os recursos:To delete the resources:

  1. No portal do Azure, selecione Grupos de recursos no canto esquerdo.In the Azure portal, select Resource groups on the far left. Se o menu esquerdo estiver recolhido, selecione Expandir botão para expandi-lo.If the left menu is collapsed, select Expand button to expand it.

  2. Selecione o grupo de recursos que você criou para este início rápido.Select the resource group you created for this quickstart.

    Selecione o grupo de recursos a excluir

  3. Na nova janela, selecione Excluir grupo de recursos.In the new window, select Delete resource group.

    Exclua o grupo de recursos

  4. Na próxima janela, insira o nome do grupo de recursos a ser excluído e selecione Excluir.In the next window, enter the name of the resource group to delete, and then select Delete.

Próximas etapasNext steps

Neste início rápido, você aprendeu como criar uma conta do BD Cosmos do Azure, como criar uma tabela usando o Data Explorer e como executar um aplicativo.In this quickstart, you've learned how to create an Azure Cosmos DB account, create a table using the Data Explorer, and run an app. Agora, você pode consultar os dados usando a API de Tabela.Now you can query your data using the Table API.