Instale o EdgeSQL Shell

EdgeSQL Shell é uma ferramenta de linha de comando em Python que gerencia os bancos de dados do SQL Database, executa SQL neles e importa dados para eles. Ela não é publicada em um índice de pacotes: você clona o repositório e a instala a partir do código-fonte. O shell se autentica com seu personal token, lido da variável de ambiente AZION_TOKEN.

Para os comandos que o shell aceita depois de instalado, consulte EdgeSQL Shell.

Atenção — EdgeSQL Shell não inicia em uma instalação limpa. Todo comando falha antes de o prompt EdgeSQL> aparecer, com ImportError: cannot import name 'Configuration' from 'kaggle.api.kaggle_api_extended': commands/import.py importa o módulo do Kaggle incondicionalmente enquanto o shell inicia, e o kaggle==1.8.3 fixado não define mais esse símbolo. Fixar uma versão anterior não resolve em uma máquina sem credenciais da Kaggle, porque o pacote autentica dentro do próprio __init__.py — 1.6.17 e 1.7.4 falham nesse ponto. Uma correção está pendente.

Neutralizar essa única importação localmente mantém o resto da ferramenta funcionando. Isso é uma solução local, não uma etapa suportada. Para as interfaces que executam o mesmo SQL até a correção ser lançada, consulte Solução de problemas.

Pré-requisitos

Python 3, com o módulo venv que vem com ele.
Os headers do Postgres. requirements.txt fixa psycopg2, que é compilado a partir do código-fonte e falha na compilação sem eles. No macOS, instale-os com brew install postgresql.
Um personal token. O shell o lê de AZION_TOKEN.
SQL Database habilitado na sua conta. O produto está em Preview e não é habilitado por padrão, então solicite acesso ao Technical Support.

Instale o shell

A instalação clona o repositório, isola as dependências em um ambiente virtual e coloca o token no ambiente que o shell lê. Para instalar o shell:

Clone o repositório

git clone https://github.com/aziontech/edgesql-shell.git

Git escreve a ferramenta em um diretório edgesql-shell dentro do diretório atual.

Entre no diretório

cd edgesql-shell

Crie e ative um ambiente virtual

Shell

01python -m venv env

02source env/bin/activate

O diretório env guarda o ambiente, e ele permanece ativo pelo resto da sessão do terminal.

Instale as dependências

pip install -r requirements.txt

Os pacotes são instalados em env, e não no Python do sistema. psycopg2 é compilado aqui, contra os headers do Postgres dos pré-requisitos.

Exporte seu personal token

export AZION_TOKEN="[TOKEN VALUE]"

Substitua [TOKEN VALUE] pelo seu personal token. A variável vale para a sessão atual do terminal.

Inicie o shell

python edgesql-shell.py

Em uma instalação limpa, a inicialização termina na falha de importação em vez do prompt:

ImportError: cannot import name 'Configuration' from 'kaggle.api.kaggle_api_extended'

A ferramenta fica instalada em edgesql-shell, com as dependências dela no ambiente env e seu token em AZION_TOKEN. O shell abre no prompt EdgeSQL>, onde cada linha que você digita é um comando do shell ou uma instrução SQL executada no banco de dados em uso.

Até o defeito acima ser corrigido, a última etapa termina no ImportError em vez de no prompt. A instalação em si está completa: o repositório, o ambiente, as dependências e o token estão todos no lugar, e o shell inicia assim que a importação do Kaggle for corrigida upstream.

Execute um comando sem o prompt interativo

Duas flags executam o shell sem o prompt. -n torna a execução não interativa e -c passa um comando. Repita -c para executar vários comandos em ordem:

python edgesql-shell.py -n -c ".use MyDB" -c ".tables"

A execução seleciona o banco de dados MyDB, lista as tabelas dele e sai. Ela também chega ao ImportError até a correção ser publicada, porque o shell carrega os mesmos módulos, não importa de que forma ele inicie.

Próximos passos

EdgeSQL ShellTodos os comandos que o shell aceita, seus argumentos, os modos de saída e as variáveis de credenciais.Importe dados com o EdgeSQL ShellCarregue um arquivo CSV, um script SQL ou outro banco de dados para uma tabela pelo shell.Crie e gerencie bancos de dadosCrie um banco de dados pelo Azion Console, pela Azion API ou pela biblioteca azion, e depois liste e exclua o banco.Solução de problemasOs sintomas que SQL Database e o shell dele retornam, e o que cada um significa.