Autorizar e executar blocos de anotações

É possível usar blocos de anotações para organizar, anotar e compartilhar várias consultas SQL em um único documento. É possível adicionar várias células de consulta SQL e Markdown a um bloco de anotações. Os blocos de anotações fornecem um modo de agrupar consultas e explicações associadas a uma análise de dados em um único documento usando várias células de consulta e Markdown. É possível adicionar texto e formatar a aparência usando a sintaxe Markdown para fornecer contexto e informações adicionais para suas tarefas de análise de dados. Você pode compartilhar os blocos de anotações com os membros da equipe.

Para usar blocos de anotações, você deve adicionar permissão para blocos de anotações à entidade principal do IAM (um usuário do IAM ou um perfil do IAM). Como prática recomendada, anexe políticas de permissões a um perfil do IAM e, depois, atribua-as a usuários e grupos, conforme necessário. Para obter mais informações, consulte Gerenciamento de identidade e acesso no Amazon Redshift. Você pode adicionar a permissão a uma das políticas gerenciadas do editor de consultas v2. Para obter mais informações, consulte Acessar o editor de consultas v2.

Você pode escolher a opção Run all (Executar tudo) para as células de um blocos de anotações. A célula de consulta SQL de um bloco de anotações tem a maioria dos mesmos recursos de uma guia do editor de consultas. Para obter mais informações, consulte Autorizar e executar consultas. A seguir estão as diferenças entre uma guia do editor de consultas e uma célula SQL de um bloco de anotações.

• Não há um controle para executar Explain em uma instrução SQL em um bloco de anotações.

• Você só pode criar um gráfico por célula SQL em um bloco de anotações.

Você pode exportar e importar blocos de anotações para arquivos criados com o editor de consultas v2. A extensão do arquivo é .ipynb e o tamanho do arquivo pode ser até 5 MB. As células SQL e Markdown são armazenadas no arquivo. Um cluster ou grupo de trabalho e um banco de dados não são armazenados no bloco de anotações exportado. Ao abrir um bloco de anotações importado, escolha o cluster ou grupo de trabalho e o banco de dados onde será executado. Depois de executar as células SQL, você pode escolher na guia de resultados se deseja exibir a página atual de resultados como um gráfico. O conjunto de resultados de uma consulta não é armazenado no bloco de anotações.

Quando você executa um notebook, com Executar tudo ou Executar, um painel de Status de execução permanece disponível. Escolha o ícone para abrir o painel. Esse painel contém um resumo do status de Executar tudo ou Executar mais recente das células SQL no notebook. Se executar várias células SQL, você poderá exibir rapidamente o status, o tempo decorrido e alguns detalhes sobre a execução. É possível filtrar as células exibidas com base no status: All, Succeeded, Error, In progress ou Canceled. Também é possível usar esse painel para navegar até uma célula SQL no editor.

Para criar um caderno

1. No menu do navegador, selecione Editor.

2. Selecione e escolha Notebook.

   Por padrão, uma célula de consulta SQL é exibida no bloco de anotações.

3. Na célula de consulta SQL, siga um destes procedimentos:

   • Insira uma consulta.

   • Cole uma consulta que você copiou.

4. (Opcional) Escolha o ícone , depois selecione Markdown para adicionar uma célula Markdown na qual você poderá fornecer texto descritivo ou explicativo usando a sintaxe Markdown padrão.

5. (Opcionalmente) Escolha o ícone , depois selecione SQL para inserir uma célula SQL.

Você pode renomear blocos de anotações usando o ícone (lápis).

No menu (mais), você também pode realizar as seguintes operações em um bloco de anotações:

• Share with my team (Compartilhar com minha equipe): para compartilhar o bloco de anotações com sua equipe, conforme definido pelas tags. Para obter mais informações, consulte Compartilhar uma consulta.

• Export (Exportar): para exportar o bloco de anotações para um arquivo local com a extensão .ipynb.

• Save version (Salvar versão): para criar uma versão do bloco de anotações. Para ver as versões de um bloco de anotações, navegue até seus blocos de anotações salvos e abra Version history (Histórico de versões).

• Duplicate (Duplicar): para criar uma cópia do bloco de anotações e abrir essa cópia em uma nova guia de bloco de anotações.

• Shortcuts (Atalhos): para exibir os atalhos disponíveis ao criar um bloco de anotações.

Como abrir um bloco de anotações salvo

1. No menu do navegador, escolha Notebooks (Blocos de anotações). Seus blocos de anotações e pastas de blocos de anotações salvos são exibidos.

2. Escolha o bloco de anotações SQL que deseja abrir e clique nele duas vezes.

Você pode mostrar My notebooks (Meus blocos de anotações), blocos de anotações Shared by me (Compartilhados por mim) e blocos de anotações Shared to my team (Compartilhados com minha equipe) na guia de blocos de anotações.

Para importar um bloco de anotações de um arquivo local para My notebooks (Meus blocos de anotações), escolha Import (Importar) e navegue até o arquivo .ipynb que contém seu bloco de anotações. O bloco de anotações é importado para a pasta de blocos de anotações aberta no momento. Você pode abrir o bloco de anotações pelo editor de blocos de anotações.

No menu de contexto (clique com o botão direito) de um bloco de anotações, você pode executar as seguintes operações:

• Open notebook (Abrir bloco de anotações): para abrir o bloco de anotações no editor.

• Save version (Salvar versão): para salvar uma versão do bloco de anotações.

• Version history (Histórico de versões): para exibir as versões de um bloco de anotações. Na janela Version history (Histórico de versões), você pode excluir e reverter versões. Você também pode criar um bloco de anotações usando a versão selecionada no momento.

• Edit tags (Editar etiquetas): para criar e editar etiquetas em um bloco de anotações.

• Share with my team (Compartilhar com minha equipe): para compartilhar um bloco de anotações com com sua equipe.

  Para compartilhar um bloco de anotações com sua equipe, verifique se tem a etiqueta da entidade principal sqlworkbench-team definida com o mesmo valor que o restante dos membros de sua equipe em sua conta. Por exemplo, um administrador pode definir o valor como accounting-team para todos os membros do departamento de contabilidade. Para ver um exemplo, consulte Permissões necessárias para usar o editor de consultas v2 .

• Export (Exportar): para exportar um bloco de anotações para um arquivo local.

• Rename (Renomear): para renomear um caderno.

• Duplicate (Duplicar): para fazer uma cópia de um bloco de anotações.

• Delete (Excluir): para excluir um bloco de anotações.

Para ver uma demonstração de blocos de notas, assista ao vídeo a seguir.