Databricks Driver para SQLTools for Visual Studio Code
Visualização
Este recurso está em visualização pública.
O Driver Databricks para SQLTools permite que você use a extensão SQLTools para Visual Studio Code para procurar objetos SQL e executar query SQL no workspace remoto do Databricks.
Antes de começar
Antes de poder usar o Driver Databricks para SQLTools, seu workspace Databricks e sua máquina de desenvolvimento local devem atender aos seguintes requisitos.
Requisitos do espaço de trabalho
Você deve ter pelo menos um workspace Databricks disponível e o workspace deve atender aos seguintes requisitos:
O site workspace deve conter pelo menos um Databricks SQL depósito.
Observação
Os clusters do Databricks não são suportados pelo Driver Databricks para SQLTools.
Para workspace habilitados para Unity Catalog, o workspace deve conter pelo menos um catálogo, com pelo menos um esquema (formalmente chamado de banco de dados) dentro desse catálogo.
Para workspace que não estão habilitados para Unity Catalog, o workspace deve conter pelo menos um esquema (anteriormente chamado de banco de dados).
Requisitos de máquina de desenvolvimento local
Você deve ter o seguinte em sua máquina de desenvolvimento local:
Visual Studio Code versão 1.70 ou superior. Para view a versão instalada, clique em Código > Sobre o Visual Studio Code no menu principal no Linux ou macOS e em Ajuda > Sobre no Windows. Para downloads, instalar e configurar o Visual Studio Code, consulte Configurando o Visual Studio Code.
A extensão SQLTools para Visual Studio Code.
A extensão Databricks Driver para SQLTools para Visual Studio Code.
Para instalar a extensão SQLTools, acesse SQLTools e clique em Instalar ou:
No Visual Studio Code, clique em view > Extensões no menu principal.
Na caixa Extensões de pesquisa no marketplace , digite
SQLTools
.Clique na entrada SQLTools de Matheus Teixeira.
Observação
Pode haver várias entradas SQLTools listadas. Certifique-se de clicar na entrada de Matheus Teixeira.
Clique em Instalar.
Para instalar a extensão Databricks Driver for SQLTools, vá para Databricks Driver for SQLTools e clique em Instalar ou:
No Visual Studio Code, clique em view > Extensões no menu principal.
Na caixa Extensões de pesquisa no marketplace , digite
Databricks Driver for SQLTools
.Clique na entrada Databricks Driver para SQLTools .
Clique em Instalar.
Autenticação
Você deve configurar a autenticação para o driver Databricks para SQLTools da seguinte maneira.
O Databricks Driver para SQLTools dá suporte aos seguintes tipos de autenticação do Databricks:
Autenticação access token pessoal do Databricks
Para usar o Databricks Driver para SQLTools com autenticação access token pessoal do Databricks, você deve ter um access token pessoal do Databricks. Para criar um access token pessoal, faça o seguinte:
Em seu Databricks workspace, clique em seu nome de usuário Databricks na barra superior e selecione Settings (Configurações ) no menu suspenso.
Clique em Desenvolvedor.
Ao lado do access token, clique em gerenciar.
Clique em Gerar novos tokens.
(Opcional) Insira um comentário que o ajude a identificar esse token no futuro e altere o tempo de vida padrão do token de 90 dias. Para criar um token sem vida útil (não recomendado), deixe a caixa Duração (dias) vazia (em branco).
Clique em Gerar.
Copie o token exibido em um local seguro e clique em Concluído.
Observação
Certifique-se de salvar os tokens copiados em um local seguro. Não compartilhe seus tokens copiados com outras pessoas. Se você perder os tokens copiados, não poderá regenerar exatamente os mesmos tokens. Em vez disso, você deve repetir este procedimento para criar novos tokens. Se você perder os tokens copiados ou acreditar que os tokens foram comprometidos, o Databricks recomenda fortemente que você exclua imediatamente esses tokens do seu workspace clicando no ícone da lixeira (Revogar) ao lado dos tokens na página access tokens .
Se o senhor não conseguir criar ou usar o site tokens no seu workspace, isso pode ocorrer porque o administrador do workspace desativou o tokens ou não lhe deu permissão para criar ou usar o tokens. Consulte o administrador do site workspace ou os tópicos a seguir:
Autenticação OAuth máquina a máquina (M2M) da Databricks
O senhor pode usar a autenticação máquina a máquina (M2M) do Databricks OAuth para se autenticar com o Databricks Driver for SQLTools, como segue:
Observação
A autenticação Databricks OAuth M2M está disponível no Databricks Driver for SQLTools versões 0.4.2 e superiores.
Conclua a configuração dos passos para a autenticação OAuth M2M. Consulte a autenticação OAuth máquina a máquina (M2M).
Crie um perfil de configuração do Databricks com suas definições de configuração de autenticação OAuth M2M. Consulte a seção "Config" da autenticação máquina a máquina (M2M) do OAuth.
Instale e abra a extensão Databricks para Visual Studio Code na sua máquina de desenvolvimento local.
Na extensão Databricks para Visual Studio Code, clique no botão Configurar no painel Configuração . Se o botão Configurar não for exibido, clique no ícone de engrenagem (Configurar workspace).
Na paleta de comandos, para Databricks Host, digite o URL da instância do espaço de trabalho do Databricks, por exemplo,
https://dbc-a1b2345c-d6e7.cloud.databricks.com
, e pressione Enter.Selecione a entrada do perfil de configuração que corresponde à que o senhor criou no passo 2.
Complete as instruções na tela do navegador da Web para concluir a autenticação com a Databricks account.
Autenticação OAuth de usuário para máquina (U2M) da Databricks
Você pode usar a autenticação usuário-máquina (U2M) do Databricks OAuth para autenticar com o driver Databricks para SQLTools, da seguinte maneira:
Observação
A autenticação Databricks OAuth U2M está disponível no Databricks Driver for SQLTools versões 0.4.2 e acima.
Instale e abra a extensão Databricks para Visual Studio Code na sua máquina de desenvolvimento local.
Na extensão Databricks para Visual Studio Code, clique no botão Configurar no painel Configuração . Se o botão Configurar não for exibido, clique no ícone de engrenagem (Configurar workspace).
No comando Palette, para Databricks Host, insira o URL da instância do espaço de trabalho do Databricks, por exemplo
https://dbc-a1b2345c-d6e7.cloud.databricks.com
. Em seguida, pressione Enter.Selecione OAuth (usuário para máquina).
Conclua as instruções na tela do seu navegador da Web para concluir a autenticação com sua account do Databricks. Se solicitado, permita acesso a
all-apis
.
Conectar a um esquema
No Visual Studio Code, na barra lateral, clique no ícone SQLTools .
Na view SQLTools , se esta for a primeira vez que você usa a extensão SQLTools, clique em Add New Connection no painel Connections . Caso contrário, clique no ícone Adicionar nova conexão na barra de título do painel.
Na guia Configurações do SQLTools, para a passo Selecionar um driver de banco de dados , clique no ícone Databricks .
Para a passo Connection Settings , insira as seguintes informações sobre seu warehouse, catálogo e esquema:
Para Connection name, insira algum nome exclusivo para esta conexão.
(Opcional) Para Grupo de conexão , insira o nome de um grupo de conexão existente para adicionar a nova conexão a esse grupo. Ou insira um nome exclusivo para criar um novo grupo de conexão com a nova conexão. Os grupos de conexão facilitam a localização de conexões no ramal.
Para Conectar usando, selecione uma das seguintes opções:
Para usar um access token pessoal do Databricks para autenticação, selecione hostname e tokens.
Para o Databricks Driver for SQLTools versões 0.4.2 e superiores, para usar a autenticação OAuth U2M ou M2M, selecione a extensão VS Code (beta).
Se você selecionou hostname e tokens para Connect usando, em seguida, para Host, insira a configuração hostnamedo servidor do warehouse. Para obter a configuração hostnamedo servidor de um warehouse, consulte Obter detalhes de conexão para um recurso de computação do Databricks.
Para Path, insira a clustersconfiguração do caminho HTTP do warehouse ou . Para obter a configuração do caminho HTTP de um armazém, consulte Obter detalhes de conexão para um recurso de computação do Databricks.
Se o senhor selecionou hostname e tokens para usar o Connect, digite seu valor pessoal do Databricks access token em tokens.
Para Catálogo, digite o nome do seu catálogo.
Observação
Para workspace que não estão habilitados para Unity Catalog, você pode deixar Catálogo em branco para usar o valor default de
hive_metastore
.Para Esquema, insira o nome do seu esquema.
(Opcional) Para Mostrar limite default registros, deixe o default de
50
para mostrar apenas até as primeiras 50 linhas para cada query ou insira um limite diferente.
Clique em Testar conexão.
Se o teste de conexão for bem-sucedido, clique em Salvar conexão.
Alterar as configurações de uma conexão
Este procedimento pressupõe que você se conectou com sucesso a pelo menos um depósito.
Se a view SQLTools não estiver visível, no Visual Studio Code, na barra lateral, clique no ícone SQLTools .
No painel Conexões , expanda o grupo de conexões, se houver um para sua conexão de destino.
Clique com o botão direito do mouse na conexão e clique em Editar conexão.
Altere as configurações de destino.
Clique em Testar conexão.
Se o teste de conexão for bem-sucedido, clique em Salvar conexão.
Navegue pelos objetos de um esquema
No painel Conexões , expanda o grupo de conexões, se houver um para sua conexão de destino.
Clique duas vezes ou expanda a conexão de destino para seu warehouse.
Expanda o banco de dados de destino (esquema), se houver um para sua conexão.
Expanda Tables or Views, se existir uma ou mais tabelas ou views para seu banco de dados (esquema).
Expanda qualquer tabela ou view de destino para view as colunas da tabela ou view .
Exibir as linhas ou o esquema de uma tabela ou exibição
Com Tabelas ou view expandida no painel Conexões , siga um destes procedimentos:
Para mostrar as linhas da tabela ou view , clique com o botão direito do mouse na tabela ou view e clique em Mostrar registros da tabela ou Mostrar registros view .
Para mostrar o esquema da tabela ou view , clique com o botão direito do mouse na tabela ou view e clique em Descrever tabela ou Descrever view.
Gerar uma consulta de inserção para uma tabela
Coloque o cursor em um editor existente no local onde deseja que a query de inserção seja adicionada.
Com Tabelas expandidas no painel Conexões , clique com o botão direito do mouse na tabela e clique em Gerar queryInserir. A definição da queryde inserção é adicionada no ponto de inserção do cursor.
Criar e executar uma consulta
Este procedimento pressupõe que você se conectou com sucesso a pelo menos um depósito.
No painel Conexões , expanda o grupo de conexões, se houver um para sua conexão de destino.
Clique duas vezes ou expanda a conexão de destino para seu warehouse.
Com a conexão selecionada, clique em Novo arquivo SQL na barra de título do painel Conexões . Uma nova tab do editor é exibida.
Insira sua query SQL no novo editor.
Para executar a query SQL, clique em execução na conexão ativa no editor. Os resultados da querysão exibidos em uma nova tab do editor.
execução de uma consulta existente
Este procedimento pressupõe que você se conectou com sucesso a pelo menos um depósito.
No painel Conexões , expanda o grupo de conexões, se houver um para sua conexão de destino.
Clique duas vezes ou expanda a conexão de destino para seu warehouse.
Com a conexão selecionada, abra qualquer arquivo com a extensão de arquivo
.sql
ou selecione qualquer grupo de instruções SQL contínuas em qualquer editor que tenha sido aberto anteriormente.Para executar a query SQL de um arquivo
.sql
aberto, com o conteúdo do arquivo.sql
exibido no editor, clique em execução na conexão ativa no editor. Os resultados da querysão exibidos em uma nova tab do editor.Para executar um grupo selecionado de instruções SQL contínuas em um editor que foi aberto anteriormente, clique com o botão direito do mouse em sua seleção e clique em execução queryselecionada. Os resultados da querysão exibidos em uma nova tab do editor.
Enviar registros de uso para a Databricks
Se tiver problemas ao usar o Databricks Driver for SQLTools, o senhor pode enviar logs e informações relacionadas ao Databricks Support da seguinte forma:
Instale a extensão Databricks para o Visual Studio Code em seu computador de desenvolvimento local.
Ative o registro marcando a configuração logs: Enabled ou definindo
databricks.logs.enabled
paratrue
, conforme descrito em Configurações para a extensão Databricks para Visual Studio Code Certifique-se de reiniciar o Visual Studio Code depois de ativar o registro.Tente reproduzir seu problema.
Na paleta de comandos (view > Paleta de comandos no menu principal), execute o comando Databricks: Open full logs comando.
Envie os arquivos
Databricks Logs.log
,databricks-cli-logs.json
esdk-and-extension-logs.json
que aparecem para o suporte da Databricks.Copie também o conteúdo do Terminal (view > Terminal) no contexto do problema e envie esse conteúdo para Databricks Support.
A saída view (view > Saída, Databricks logs ) mostra informações truncadas se logs: Enabled estiver marcado ou databricks.logs.enabled
estiver definido como true
. Para mostrar mais informações, altere as seguintes configurações, conforme descrito em Configurações da extensão Databricks para o Visual Studio Code:
logs: Comprimento máximo da matriz ou
databricks.logs.maxArrayLength
logs: Comprimento máximo do campo ou
databricks.logs.maxFieldLength
logs: Profundidade de truncamento ou
databricks.logs.truncationDepth