Blob Storage (Azure)

A Digibee Integration Platform oferece várias opções para armazenamento de arquivos. O Portal de Documentação ajuda os usuários a identificar a melhor solução. Esse artigo aborda Blob Storage (Azure).

O Blob Storage (Azure) possibilita que você trabalhe com arquivos armazenados em containers da Azure Blob Storage.

Parâmetros

Dê uma olhada nas opções de configuração do componente. Parâmetros suportados por expressões Double Braces estão marcados com (DB).

Parâmetro	Descrição	Valor padrão	Tipo de dado
Account	Conta a ser utilizada pelo componente. As contas suportadas são: Basic e Public key. A Basic é utilizada para se conectar via ConnectionString; o nome da storage account deve ser passado no campo "user" e a key1 no campo "password". A Public key é utilizada caso queira autenticar via SAS token; use a public-key no campo "key", e depois passe o SAS token gerado pela Azure. Leia a documentação sobre Contas (Accounts) para saber mais sobre esses e outros tipos de contas existentes.	N/A	String
Operation	Define qual operação o componente irá realizar (List, Download, Upload ou Delete). O preenchimento deste campo é obrigatório.	Upload	String
Container Name	Nome do container do Blob Storage (Azure) que manipulará os arquivos. O preenchimento deste campo é obrigatório.	container	String
Container Account	Nome da conta Azure que o Blob Storage utiliza. O preenchimento deste campo é obrigatório.	N/A	String
Remote File Name (DB)	Nome do arquivo ou caminho completo do arquivo remoto (ex.: tmp/file.txt). O preenchimento deste campo é obrigatório apenas quando as operações Upload, Download ou Delete estiverem selecionadas.	test.csv	String
File Name (DB)	Nome do arquivo ou caminho completo (full file path, por exemplo tmp/processed/file.txt) para o arquivo local. O preenchimento deste campo é obrigatório.	file.csv	String
Generate a Download Link	Se a opção é habilitada, você poderá gerar um link para download do arquivo. Este parâmetro é mostrado somente quando a operação Upload é selecionada.	True	Booleano
Page Size (DB)	Quantidade de registros que deseja trazer por página. Este parâmetro é mostrado somente quando a operação List é selecionada.	N/A	Inteiro
Prefix	Filtra os resultados para retornar apenas blobs cujos nomes começam com o prefixo especificado. Este parâmetro é mostrado somente quando a operação List é selecionada.	N/A	String
Next Page Token (DB)	NextToken que será usado para trazer os registros da próxima página. Este parâmetro é mostrado somente quando a operação List é selecionada.	N/A	String
Next Token Type (DB)	Tipo do próximo registro que será listado na próxima página. Este parâmetro é mostrado somente quando a operação List é selecionada.	N/A	String
Overwrite File on Upload	Sobrescreve o arquivo no momento do upload. Este parâmetro é mostrado somente quando a operação Upload é selecionada.	True	Booleano
Snapshot	Se a opção for ativada, irá incluir snapshots na resposta dos blobs. Disponível somente para a operação List.	N/A	Booleano
Metadata	Se a opção for ativada, irá incluir metadados (metadata) na resposta dos blobs. Disponível somente para a operação List.	N/A	Booleano
Uncommited	Se a opção for ativada, irá incluir uncommited blobs na resposta. Disponível somente para a operação List.	N/A	Booleano
Copy	Se a opção for ativada, irá incluir copy blobs na resposta. Disponível somente para a operação List.	N/A	Booleano
Delete	Se a opção for ativada, irá incluir delete blobs na resposta. Disponível somente para a operação List.	N/A	Booleano
Fail On Error	Se a opção estiver habilitada, a execução do pipeline com erro será interrompida; do contrário, a execução do pipeline continua, mas o resultado vai mostrar um valor falso para a propriedade "success".	False	Booleano

Fluxo de mensagens

Operação List

{
"success": true,
"content": [
{
"fileName": "my-remote-file.txt",
"containerName": "newcontainer",
"properties": {
"createdDate": "Fri May 20 13:41:12 UTC 2022",
"lastUpdated": "Wed May 25 14:59:26 UTC 2022",
"contentType": "application/octet-stream",
"length": 23
}
},
{
"fileName": "testeOverwrite.txt",
"containerName": "newcontainer",
"properties": {
"createdDate": "Tue Jun 14 18:11:35 UTC 2022",
"lastUpdated": "Tue Jun 14 18:11:47 UTC 2022",
"contentType": "application/octet-stream",
"length": 76952
}
}
],
"count": 2,
"containerName": "newcontainer"
}

Operação Upload

{
"success": true,
"fileName": "teste-upload.jpeg",
"containerName": "teste",
"remoteFileName": "teste-upload.jpeg",
"urlGenerated": "
https://digibeeblobstorage.blob.core.windows.net/teste/teste-upload.jpeg
"
}

Operação Download

Importante: Utilizar o componente File Reader para manipular o base64 retornado.

Operação Delete

{
"success": true,
"containerName": "newcontainer",
"remoteFileName": "teste-upload.jpeg"
}