Conectores
Dados e Armazenamento
Storage
22min
objetivo/resumo o conector storage da fluid oferece uma interface simplificada e padronizada para armazenar, recuperar, listar e deletar dados de forma eficiente e escalável no armazenamento dedicado ao seu tenant/workspace ele integra se perfeitamente com as soluções de integração da fluid, permitindo que você gerencie informações estruturadas por meio de identificadores únicos, sem demandar um armazenamento externo e se preocupar com gerenciamento de banco de dados cada identificador pode conter um ou mais conjuntos de dados organizados em pares de chave ( key ) e valor ( value ) , facilitando a organização e o acesso aos dados conforme necessário criando conexão para o conector storage para utilizar o conector storage, é necessário criar uma conexão e, em seguida, configurar o fluxo abaixo estão as instruções detalhadas criando conexão acessar o painel principal faça login na plataforma fluid no painel à esquerda, navegue até a opção "conexões" e clique nela iniciar nova conexão no canto superior direito, clique em "nova conexão" seleção do tipo de conexão na tela de configuração, localize "configure uma nova conexão" e selecione "storage" da lista suspensa nome da conexão forneça um nome descritivo para a conexão no campo "nome" descrição da conexão no campo "descrição", forneça uma breve descrição da conexão chave/key insira a chave/key da tabela do storage que será utilizada pela api pode ser criada de acordo com o nome que você desejar operações 1\ salvar descrição a operação de salvar permite que você armazene informações novas, atualize informações existentes, ou acrescente novas informações associadas a um identificador específico como funciona ao salvar, você fornece um identificador único que será usado para agrupar os conjuntos de informações que deseja armazenar cada conjunto consiste em pares de chave ( key ) e valor ( value ), que representam os dados que você quer guardar ao salvar habilitando o campo salvar como append os valores que informar serão acrescentados ao identificador caso ele já exista exemplo prático imagine que você está salvando informações de clientes o identificador pode ser o número do cliente, e os pares de key/values podem incluir nome, endereço e e mail 2\ recuperar chave descrição a operação de recuperar chave permite que você obtenha uma chave específica que esteja salva no identificador se a chave não existir, retornará uma mensagem informando que a chave não existe \\ como funciona ao fornecer o identificador previamente usado para salvar as informações e informar a chave específica que deseja retornar, você pode recuperar o valor salvo para a chave informada dentro do identificador exemplo prático se você salvou informações do cliente com o identificador 00001 1 e a chave nome e valor cliente de testes , ao utilizar a operação de recuperar chave com o identificador 00001 1 e a chave nome , você obterá o valor cliente de testes que foi salvo anteriormente para a chave nome { "id" "00001 1", "table key" " ", "values" { "nome" "cliente de testes" } } 3\ verificar chave descrição a operação de verificar chave, verifica se a chave existe no identificador previamente informado do storage retorna true se a chave existir e false se não existir como funciona ao fornecer o identificador previamente usado para salvar as informações e informar a chave específica que deseja verificar, será retornado um json informando se a chave existe ou não exemplo prático se você salvou informações do cliente com o identificador 00001 1 e a chave nome , ao utilizar a operação verificar chave com o identificador 00001 1 e a chave nome , você obterá dentro da tag exist o valor true { "id" "00001 1", "table key" " ", "values" { "exist" true } } 4\ listar descrição a operação de listar permite que você veja todos os identificadores disponíveis juntamente com seus conjuntos de key/values associados como funciona ao utilizar a operação de listar, você receberá uma lista de todos os identificadores armazenados no banco de dados, juntamente com os conjuntos de key/values associados a cada um deles exemplo prático se você está gerenciando informações de vários clientes, a operação de listar fornecerá uma visão geral de todos os clientes existentes, cada um com suas respectivas informações armazenadas \[ { "id" "00001 1", "table key" "clientes", "values" { "cliente" "fulando de tal", "endereço" "rua sem saída, n 10, centro", "email" "fulando\@exemplo com" } }, { "id" "00002 1", "table key" "clientes", "values" { "cliente" "cilano de tal", "endereço" "rua teste, n 20, centro", "email" "cilano\@exemplo com" } } ] 5\ listar com prefixo descrição a operação listar com prefixo verifica no storage todos os identificadores que iniciem com o prefixo informado retorna todos os identificadores encontrados e seus respectivos conjuntos de chaves e valores como funciona ao fornecer o prefixo do identificador, será retornado um json com todos os identificadores que iniciem com esse prefixo exemplo prático se você salvou um cliente com o identificador 00001 1 e outro com o identificador 00002 1 , e deseja buscar todos os identificadores que iniciem com o prefixo 0000 , ao utilizar a operação listar com prefixo, passando o prefixo 0000 , serão listados tanto o cliente 00001 1 quanto o cliente 00002 1 \[ { "id" "00001 1", "table key" "clientes", "values" { "cliente" "fulano de tal", "endereço" "rua sem saída, n 10, centro", "email" "fulano\@exemplo com" } }, { "id" "00002 1", "table key" "clientes", "values" { "cliente" "ciclano de tal", "endereço" "rua teste, n 20, centro", "email" "ciclano\@exemplo com" } } ] 6\ deletar descrição a operação de deletar permite que você remova completamente um identificador específico e todos os seus conjuntos de key/values associados como funciona ao fornecer o identificador que deseja excluir, todos os dados associados a esse identificador serão permanentemente removidos do armazenamento exemplo prático se um cliente não é mais ativo e você deseja remover todas as informações dele do sistema, você pode usar a operação de deletar com o identificador desse cliente para eliminar todas as informações associadas 7\ deletar chave descrição a operação deletar chave permite excluir uma chave específica que esteja salva em um identificador após a execução, será retornada a quantidade de registros afetados no storage como funciona ao fornecer o identificador previamente utilizado para salvar as informações, junto com a chave específica que deseja deletar, a chave será removida do identificador exemplo prático se você salvou informações de um cliente com o identificador 00001 1 e a chave nome , ao utilizar a operação deletar chave com o identificador 00001 1 e a chave nome , essa chave será deletada, e será retornada a quantidade de registros afetados { "last inserted id" 0, "rows affected" 1 } 8\ limpar storage descrição a operação limpar storage permite deletar todos os identificadores de uma determinada conexão após a execução, será retornada a quantidade de registros afetados no storage como funciona ao selecionar a operação o conector irá efetuar a limpeza completa do storage com base na conexão selecionada exemplo prático caso de uso gerenciamento de pedidos pendentes no erp cenário você está implementando uma integração de pedidos entre o seu e commerce e erp se o cliente associado ao pedido não estiver cadastrado no erp, o pedido não pode ser registrado e deve ser salvo temporariamente em um storage até que o cliente seja cadastrado e o pedido reenviado fluxo do caso de uso 1\ cadastro de pedido no erp objetivo tentar cadastrar um pedido no erp passos enviar dados do pedido o sistema envia dados do pedido para o erp verificar resposta do erp se o cliente associado ao pedido já estiver cadastrado, o pedido é registrado com sucesso se o cliente não estiver cadastrado, o erp retorna um erro exemplo pedido pedido123 cliente cliente456 (não cadastrado no erp) produto laptop quantidade 1 2\ salvar pedido no storage objetivo se o pedido não puder ser cadastrado no erp devido ao cliente não estar registrado, salvar o pedido no storage para processamento futuro passos definir identificador use um identificador único para o pedido, como o id do pedido ( pedido123 ) salvar dados chaves e valores cliente cliente456 produto laptop quantidade 1 operação salvar 3\ listar pedidos salvos no storage objetivo recuperar todos os pedidos que foram salvos no storage para tentar reenviá los ao erp passos executar operação de listar liste todos os identificadores e seus pares chave/valor armazenados operação listar exemplo de resultado identificador pedido123 cliente cliente456 produto laptop quantidade 1 objetivo listar os pedidos pendentes de envio e direcionar para o fluxo de reenvio do pedido 4\ deletar pedido do storage objetivo após o pedido ser cadastrado com sucesso no erp, remova o do storage para evitar processamento duplicado passos definir identificador use o mesmo identificador do pedido ( pedido123 ) operação deletar resumo das funções salvar adiciona ou substitui pares chave/valor para um identificador recuperar obtém pares chave/valor para um identificador específico listar mostra todos os identificadores e seus pares chave/valor deletar remove um identificador e seus dados do storage dicas e considerações escolha de conexão certifique se de selecionar a conexão apropriada para o tipo de dados que está manipulando uso de identificadores use identificadores únicos para evitar sobrescrever dados inadvertidamente conclusão o conector de storage da fluid é uma ferramenta essencial para a gestão eficiente de dados, oferecendo operações intuitivas e robustas para armazenar, recuperar, listar e deletar informações sem se preocupar em gerenciar banco de dados ele se integra perfeitamente com outras soluções da fluid, proporcionando uma experiência de uso coesa e simplificada com sua capacidade de gerenciar dados estruturados através de identificadores únicos, o conector de storage não apenas facilita a organização dos dados, mas também garante que eles sejam acessíveis e manipuláveis conforme as necessidades de seu aplicativo ou sistema independentemente da complexidade dos dados, o conector de storage oferece uma solução confiável e escalável para todas as suas necessidades de armazenamento