Como conectar o Azure Blob Storage
Este tutorial mostra como dar à Dattos acesso a um container do Azure Blob Storage, para que os processos busquem arquivos de entrada e entreguem arquivos exportados nele. Para entender a integração como um todo, veja Repositórios de arquivos: quais a Dattos conecta e como cadastrar.
O que você precisa
Acesso ao portal do Azure com permissão para ver as chaves de acesso da conta de armazenamento (ou alguém do time de nuvem que faça isso).
O container já criado na conta de armazenamento.
A Dattos se conecta com a chave de acesso da conta de armazenamento. Não é possível usar token SAS nem login pelo Microsoft Entra ID. Confira na conta de armazenamento, em Configurações › Configuração, se a opção Permitir acesso à chave de conta de armazenamento está Habilitada; desabilitada, o Azure recusa a conexão. Como a chave dá acesso a todos os dados da conta, avalie usar uma conta de armazenamento dedicada à troca de arquivos com a Dattos.
1. Crie as pastas no container
Num container comum, pasta é só o começo do nome dos arquivos: a pasta existe enquanto houver ao menos um arquivo dentro dela, e uma pasta vazia não aparece na lista da Dattos. Para criar a pasta:
No portal, abra o container e clique em Carregar (Upload).
Em Avançado, preencha Carregar na pasta (Upload to folder) com o caminho, por exemplo
entrada/extratos.Escolha o primeiro arquivo real e envie.
Para a pasta de saída, qualquer arquivo serve, porque a Dattos só grava nela e não lê o que já está lá. Na pasta de origem, envie um arquivo real: tudo o que estiver na pasta de origem entra na próxima execução automática.
Depois da primeira execução, a pasta de origem continua existindo mesmo sem arquivo novo, porque a Dattos guarda os arquivos processados na subpasta .processed dentro dela. Contas de armazenamento com namespace hierárquico habilitado (Data Lake Storage) aceitam pasta vazia normalmente.
2. Pegue os dados de acesso no portal do Azure
Abra a conta de armazenamento.
Anote o nome da conta de armazenamento, que aparece no topo da página (por exemplo,
empresafinanceiro).No menu da conta, em Segurança + rede, selecione Chaves de acesso.
Clique em Mostrar chaves e copie o valor de Chave da chave1. Não use a Cadeia de conexão: a Dattos pede só a chave.
Em Armazenamento de dados › Contêineres, anote o nome do container.
Para ver as chaves, o seu usuário no Azure precisa do papel Proprietário, Colaborador ou Função de Serviço de Operador de Chave da Conta de Armazenamento naquela conta.
Se a conta de armazenamento restringe o acesso por rede (Rede › Acesso à rede pública limitado a redes selecionadas), peça ao suporte da Dattos os endereços que devem ser liberados.
3. Cadastre a credencial na Dattos
Clique no ícone de engrenagem e abra Geral › Credenciais.
Clique em + Nova credencial e, na aba Armazenamento, escolha Azure Blob Storage.
Preencha os campos:
Campo | O que informar | Obrigatório |
|---|---|---|
Nome da credencial | Um nome que identifique o container, como "Azure Financeiro - extratos" | Sim |
Conta | O nome da conta de armazenamento, sem | Sim |
Chave de Acesso | A chave copiada no passo 2 | Sim |
Container | O nome do container | Sim |
Prefixo | Opcional. Limita a Dattos a uma parte do container, por exemplo | Não |
Perfis de privacidade | Quem pode usar esta credencial nos processos | Sim |
Clique em Salvar.
O Azure Blob Storage não tem o botão Testar conexão. Para conferir o acesso, siga o próximo passo.
4. Confira e ligue o container a um processo
Abra um processo Turbo AI com o fluxo publicado e vá em Diretório de Origem.
Clique em Editar na fonte desejada, depois em Adicionar destino.
Em Integração de Armazenamento, escolha a credencial que você criou.
Se as pastas do container aparecerem em Pastas de Importação, o acesso está certo. Escolha a pasta e salve.
O passo a passo completo, inclusive da saída, está em Integração com repositórios de arquivos: diretórios de origem e de saída.
Se você trocar a chave no Azure
Ao regenerar uma chave no Azure, a chave antiga para de funcionar na hora. Para trocar sem interromper os processos, siga a ordem que a Microsoft recomenda:
Edite a credencial na Dattos e cole a chave2 em Chave de Acesso.
No Azure, em Chaves de acesso, clique em Regenerar na chave1.
Volte à credencial na Dattos e cole a chave1 nova.
Regenere a chave2 no Azure.
Como ver os arquivos do container
A Dattos mostra as pastas, mas não os arquivos. Para conferir se o arquivo chegou, se foi para .processed ou para .error, ou se a exportação foi entregue, abra o container no portal do Azure (Armazenamento de dados › Contêineres) ou use o Gerenciador de Armazenamento do Azure (Azure Storage Explorer), um aplicativo gratuito da Microsoft.
Problemas comuns
O que você vê | Causa provável |
|---|---|
Erro ao carregar as pastas | Nome da conta, chave ou container errados, container inexistente, chave trocada no Azure, acesso por chave desativado ou acesso de rede bloqueado |
Uma pasta não aparece na lista | A pasta está fora do Prefixo informado ou ainda não existe no container |