As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Navegue pelos dados usando a extensão SQL
<a name="sagemaker-sql-extension-features-data-discovery"></a>

Para abrir a interface de usuário (UI) da extensão SQL, escolha o ícone da extensão SQL (![](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/studio/sqlexplorer/sqlexplorer-icon.png)) no painel de navegação do seu JupyterLab aplicativo no Studio. A visualização de descoberta de dados do painel esquerdo se expande e exibe todas as conexões pré-configuradas do armazenamento de dados com o Amazon Athena, o Amazon Redshift e o Snowflake.

A partir daí, você pode:
+ Expandir uma conexão específica para explorar seus bancos de dados, esquemas, tabelas ou visualizações e colunas.
+ Pesquisar uma conexão específica usando a caixa de pesquisa na interface de usuário da extensão SQL. A pesquisa retorna quaisquer bancos de dados, esquemas, tabelas ou visualizações que correspondam parcialmente à sequência de caracteres inserida.

**nota**  
Se o Athena já estiver configurado em sua AWS conta, você poderá habilitar um `default-athena-connection` em seu JupyterLab aplicativo. Isso permite que você execute consultas do Athena sem precisar criar a conexão manualmente. Para ativar a conexão padrão do Athena:  
Verifique com seu administrador se sua função de execução tem as permissões necessárias para acessar o Athena e o AWS Glue catálogo. Para obter detalhes sobre as permissões necessárias, consulte [Configurar uma AWS Glue conexão para Athena](sagemaker-sql-extension-datasources-glue-connection.md#sagemaker-sql-extension-athena-glue-connection-config).
Em seu JupyterLab aplicativo, navegue até o menu **Configurações** na barra de navegação superior e abra o menu **Editor de configurações**.
Escolha **Data Discovery**.
Marque a caixa **Ativar conexão padrão do Athena**.
Você pode atualizar o padrão, `primary` WorkGroup se necessário.

Para consultar um banco de dados, esquema ou tabela em um JupyterLab notebook, a partir de uma determinada conexão no painel de extensão SQL:
+ Escolha o ícone de três pontos (![SQL extension three dots icon.](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/studio/sqlexplorer/sqlexplorer-3dots-icon.png)) no lado direito de qualquer banco de dados, esquema ou tabela.
+ Selecione **Consultar no caderno** no menu.

  Isso preenche automaticamente uma célula do notebook JupyterLab com o comando `%%sm_sql` mágico relevante para se conectar à fonte de dados. Isso também adiciona um exemplo de instrução SQL para ajudar você a começar a consultar imediatamente. Você pode refinar ainda mais a consulta SQL usando os atributos de preenchimento automático e destaque da extensão. Consulte [Recursos do editor SQL da extensão JupyterLab SQL](sagemaker-sql-extension-features-editor.md) para obter mais informações sobre como usar o editor SQL da extensão SQL.

No nível da tabela, o ícone de três pontos fornece a opção adicional de escolher **pré-visualizar** os metadados de uma tabela.

O conteúdo da célula do JupyterLab notebook abaixo mostra um exemplo do que é gerado automaticamente ao selecionar o menu **Consultar no notebook** em uma fonte de `redshift-connection` dados no painel de extensão SQL.

```
%%sm_sql --metastore-id redshift-connection --metastore-type GLUE_CONNECTION

-- Query to list tables from schema 'dev.public'
SHOW TABLES
FROM
  SCHEMA "dev"."public"
```

Use o símbolo de *menor que* (![Icon to clear the SQL extension search box.](http://docs.aws.amazon.com/pt_br/sagemaker/latest/dg/images/studio/sqlexplorer/sqlexplorer-search-clear.png)) na parte superior do painel da extensão SQL para limpar a caixa de pesquisa ou retornar à lista de suas conexões.

**nota**  
A extensão armazena em cache os resultados da exploração para acesso rápido. Se os resultados em cache estiverem desatualizados ou se uma conexão estiver faltando na lista, você poderá atualizar manualmente o cache escolhendo o botão **Atualizar** na parte inferior do painel da extensão SQL. Para ter mais informações sobre o cache de conexão, consulte [Cache de conexão da extensão de SQL](sagemaker-sql-extension-features-connection-caching.md).