Gerenciar tabelas e visões
O PlaidCloud permite organizar e gerenciar tabelas, incluindo rótulos. As tabelas estão disponíveis para todos os fluxos de trabalho de um projeto e têm muitas ferramentas e opções.
Além das tabelas, o PlaidCloud também oferece Visões baseadas nos dados das tabelas. Usar Visões permite atualizações instantâneas quando ocorrem alterações nas tabelas subjacentes, além de economizar espaço de armazenamento de dados.
As opções incluem:
- A mesma tabela pode existir em vários caminhos da hierarquia (hierarquias alternativas)
- As tabelas podem receber tags para facilitar a pesquisa e a inclusão em processos do PlaidCloud
- As tabelas podem ter versões
- As tabelas podem ser publicadas para ficarem disponíveis para as visualizações de painéis
O PlaidCloud usa um sistema baseado em caminhos para organizar as tabelas, como o que você usaria para navegar por uma série de pastas, permitindo uma organização mais flexível e lógica das tabelas. Com esse sistema, as tabelas podem ser movidas dentro de uma hierarquia, ou é possível criar várias referências a uma mesma tabela a partir de locais diferentes da hierarquia (hierarquias alternativas). A capacidade de gerenciar tabelas dessa forma permite que a estrutura reflita necessidades operacionais, de relatórios e de controle.
Encontrar tabelas
Seção intitulada “Encontrar tabelas”Use Filtro na parte inferior da lista, ao lado da contagem de linhas, para pesquisar nomes e rótulos de tabelas. Pressione / ou Ctrl/Cmd+F para ir até ele. O mesmo filtro se aplica à árvore e à lista simples. A chave Todos | Publicado ao lado do filtro restringe a lista às tabelas publicadas; ela vem definida como Todos por padrão e se aplica tanto à árvore quanto à lista simples.
Por fluxo de trabalho
Seção intitulada “Por fluxo de trabalho”A pasta Por fluxo de trabalho no final da guia Tabelas agrupa as tabelas sob cada fluxo de trabalho que as lê ou grava. Abra um fluxo de trabalho para ver as tabelas dele. A pasta é uma visão das mesmas tabelas, então você não pode mover nem copiar nada a partir dela.
Por coluna
Seção intitulada “Por coluna”Selecione Localizar coluna na barra de ferramentas da guia Tabelas para encontrar as tabelas que têm uma coluna com um determinado nome. A pesquisa lê nomes de colunas, não os dados, então é rápida, e encontra somente tabelas que já foram criadas. A janela abre na última pesquisa que você executou naquele projeto desde que abriu o projeto, se você executou alguma.
Digite pelo menos dois caracteres e os resultados são atualizados enquanto você digita, ou pressione Enter para pesquisar imediatamente. Quando os resultados do que você digitou estiverem sendo exibidos, Enter na caixa de pesquisa seleciona a tabela realçada, como em uma linha. Escolha como o nome é correspondido:
- Exata — o nome inteiro da coluna, sem diferenciar maiúsculas de minúsculas
- Contém — parte do nome da coluna, sem diferenciar maiúsculas de minúsculas. Este é o padrão.
- Aproximada — nomes parecidos, ignorando maiúsculas e minúsculas, espaços, sublinhados e outros separadores, e tolerando pequenos erros de digitação. As correspondências mais próximas vêm primeiro.
A janela lembra a correspondência que você escolheu por último naquele navegador. Enquanto a caixa de pesquisa está vazia, ela lista suas cinco últimas pesquisas no projeto nesse navegador; selecione uma para executá-la novamente. Uma pesquisa conta como executada e entra na lista quando você pressiona Enter, a seleciona na lista ou age sobre os resultados dela.
Cada tabela correspondente ocupa uma linha, com seu nome, seu caminho e as três primeiras colunas correspondentes. A linha acima dos resultados conta as tabelas encontradas até o momento enquanto a pesquisa é executada. Quando nada corresponde com Exata ou Contém, selecione Tentar Aproximada? para pesquisar novamente com Aproximada. Se a pesquisa falhar ou parar antes do fim, selecione Tentar novamente. Quando não foi possível ler as colunas de algumas tabelas, os resultados informam que podem estar incompletos.
Quando os resultados incluem mais de um nome de coluna, chips acima da lista nomeiam até 12 deles, os mais comuns primeiro, cada um com o número de tabelas que o têm. Selecione um chip para listar somente as tabelas com aquela coluna e selecione-o novamente para listar todas.
Expanda uma linha para ver:
- Colunas correspondentes — cada coluna correspondente, com seu tipo quando ele é texto, inteiro, número, data, timestamp ou booleano. Uma coluna exibida na cor de aviso tem um tipo diferente em outras tabelas dos resultados; passe o mouse sobre ela para ver os tipos.
- Alimentada por — as tabelas lidas pelas etapas que gravam esta tabela, cada uma com o nome da etapa
- Alimenta — as tabelas gravadas pelas etapas que leem esta tabela, cada uma com o nome da etapa
Somente as etapas do mesmo projeto são listadas.
Para agir sobre os resultados:
- Clique duas vezes em uma linha, ou pressione Enter nela, para fechar a janela e selecionar aquela tabela na guia Tabelas. Se uma pesquisa de colunas exibida na árvore ou a chave Todos | Publicado ocultar a tabela, ela é limpa e uma mensagem avisa você. Pressione Ctrl+Enter, ou Cmd+Enter em um Mac, para abrir a tabela no Explorador de tabelas. As teclas de seta para cima e para baixo na caixa de pesquisa se movem entre as linhas.
- Selecione Mostrar na árvore para restringir a árvore e a lista simples às tabelas dos resultados, ou às tabelas do chip selecionado, e abrir as pastas da árvore que as contêm. Um chip acima da lista nomeia a pesquisa e conta suas tabelas. Selecione o chip para abrir a pesquisa novamente, ou o × nele para mostrar todas as tabelas. Atualizar a guia Tabelas executa a pesquisa novamente.
- Selecione Copiar para copiar as tabelas listadas, uma por linha, com o nome, o caminho, as colunas correspondentes e os tipos delas de cada tabela separados por tabulações.
Mostrar na árvore e Copiar ficam disponíveis quando a pesquisa termina com pelo menos uma tabela.
Um assistente de IA conectado por MCP encontra as mesmas tabelas com table_find(column=...). Ele corresponde ao nome inteiro, a parte dele, ao início ou ao fim dele, ou a nomes parecidos com column_match='fuzzy', e retorna os tipos das colunas correspondentes e, em uma correspondência aproximada, o quão próxima é a melhor coluna.
Pesquisar valores
Seção intitulada “Pesquisar valores”Para descobrir quais tabelas contêm um valor, escolha Buscar valores nos dados… (lento) no menu Ações da guia Tabelas, ou clique com o botão direito em uma tabela e escolha essa opção para procurar somente nela. Digite o valor, escolha Contém para corresponder a parte de um valor e selecione Pesquisar. Cada tabela que contém o valor é listada com as colunas em que ele aparece e alguns dos valores correspondentes. Clique duas vezes em uma tabela, ou pressione Enter nela, para abri-la no Explorador de tabelas. Uma coluna abre a tabela filtrada pelas linhas que correspondem.
Antes de pesquisar, saiba que:
- A pesquisa lê todas as linhas de todas as tabelas pesquisadas, então pode ser muito lenta e usar muitos recursos do warehouse. A janela avisa você, e os botões de pesquisa ficam desativados até que uma pesquisa termine.
- Você vê somente as linhas que já poderia abrir. A segurança em nível de linha se aplica a toda pesquisa.
- O histórico de consultas do seu warehouse registra os valores que você pesquisa.
- A pesquisa abrange as colunas de texto das tabelas. As tabelas que não foram criadas são ignoradas e citadas em um aviso.
- Os resultados vêm em páginas. Quando a linha de status informa que a pesquisa parou antes do fim, escolha Pesquisar mais para continuar com as tabelas ainda não pesquisadas.
Um assistente de IA conectado por MCP usa table_value_search. Ele retorna as tabelas e colunas que contêm o valor, nunca os valores em si. Quando você pede ao assistente de IA em um projeto para encontrar um valor, o Weave envia os nomes das tabelas e colunas correspondentes ao provedor do modelo de linguagem.
Importar um arquivo CSV
Seção intitulada “Importar um arquivo CSV”Para transformar um arquivo CSV em uma nova tabela neste projeto:
- Arraste o arquivo do seu computador para a lista Tabelas do projeto, ou escolha Novo > Tabela a partir de arquivo CSV na barra de ferramentas e solte o arquivo na caixa ou clique em Escolher um arquivo CSV.
- O PlaidCloud carrega o arquivo para o seu Personal Temp Drive, ou para o Temp Drive do espaço de trabalho se você não tiver um, e o importa para uma nova tabela no nível superior da lista, com o nome do arquivo:
Sales Data.csvvirasales_data. Se o projeto já tiver uma tabela com esse nome, a nova recebe um número, comosales_data_2. - A lista é atualizada com a nova tabela selecionada, e Seus dados em resumo abre nela. Consulte Comece com seu próprio CSV para ver o que o painel mostra.
Somente arquivos terminados em .csv são aceitos. Você precisa de permissão para criar tabelas e gravar no armazenamento de documentos, e um projeto bloqueado não aceita um CSV até ser desbloqueado. Se a importação falhar, a janela explica o motivo e o projeto permanece como estava. O PlaidCloud exclui o arquivo carregado da unidade temporária quando a importação termina, tenha ela dado certo ou não; se isso não acontecer, a unidade temporária o exclui após um dia.
Para mover uma tabela:
- Arraste-a para a pasta em que você quer que ela fique
Para mover uma tabela para o nível superior do projeto, arraste-a para o espaço vazio abaixo da última linha. Nos seletores de pasta, / é o nível superior do projeto.
Renomear
Seção intitulada “Renomear”Para renomear uma tabela:
- Clique com o botão direito na tabela
- Selecione a opção de renomear
- Digite o novo nome e salve
- A tabela agora está renomeada, mas mantém seu identificador exclusivo original.
Para limpar uma tabela:
- Selecione as tabelas na hierarquia ‘
- Clique no botão de limpar na barra de ferramentas superior.
Observação: você pode limpar uma única tabela ou várias tabelas
Excluir
Seção intitulada “Excluir”Para excluir uma tabela:
- Selecione as tabelas na hierarquia
- Clique no botão de excluir na barra de ferramentas superior
- A operação de exclusão verifica se a tabela está em uso por etapas de fluxo de trabalho ou Visões. Se estiver, você será solicitado a remover essas associações antes que a exclusão possa ocorrer.
Observação: você também pode forçar a exclusão da(s) tabela(s). A exclusão forçada deixa referências quebradas, portanto deve ser usada com moderação.
Última leitura
Seção intitulada “Última leitura”A janela de exclusão mostra quando a tabela foi lida pela última vez, por exemplo Last read 3 days ago by uma pessoa ou etapa, para que você distinga uma tabela que ninguém usa de uma que ainda está em uso. O PlaidCloud obtém isso do histórico de consultas do seu próprio warehouse e deixa de fora as leituras feitas pela própria manutenção dele.
| Warehouse | O que é necessário |
|---|---|
| Snowflake | As leituras vêm do Access History, que o Snowflake registra com até cerca de 3 horas de atraso. A função da conexão precisa da função de banco de dados SNOWFLAKE.GOVERNANCE_VIEWER (IMPORTED PRIVILEGES no banco de dados SNOWFLAKE também funciona). A edição Standard do Snowflake não tem Access History. |
| Databricks | As leituras vêm da tabela de linhagem, que o Databricks também registra com atraso, então uma leitura recente pode ainda não aparecer. A identidade da conexão precisa de USE CATALOG em system, USE SCHEMA em system.access e SELECT em system.access.table_lineage. |
| PlaidCloud Lakehouse | O histórico de leituras ainda não está disponível. A janela mostra Read history incomplete. |
Quando você conecta seu warehouse, a verificação da conexão recomenda qualquer uma dessas concessões que estiver faltando, cada uma com a instrução a executar. Elas são recomendadas, não obrigatórias: sem elas o warehouse se conecta e a janela mostra Read history incomplete.
Quando o PlaidCloud não consegue ler o histórico inteiro, a linha diz Read history incomplete e nunca informa “nenhuma leitura” no lugar. Qualquer pessoa com acesso SQL direto ao seu warehouse pode definir uma tag de sessão que altera como as próprias leituras dela são rotuladas.
Um assistente de IA conectado por MCP obtém a mesma resposta de table_describe(include=['last_read']).
Ver as colunas de uma tabela
Seção intitulada “Ver as colunas de uma tabela”Selecionar uma tabela abre seu painel de detalhes. A seção Colunas lista cada coluna com seu Tipo e sua Descrição, vinda de Propriedades da coluna. Aponte para uma linha para ler uma descrição longa por completo.
Uma tabela que não está no warehouse no momento, porque seus dados expiraram ou nenhuma etapa a criou, não tem colunas para listar. A seção informa isso e mostra quantas colunas a tabela tem. Execute uma etapa que grave a tabela para listá-las.
Ver onde uma tabela é usada
Seção intitulada “Ver onde uma tabela é usada”Selecionar uma tabela abre seu painel de detalhes, que lista as etapas de fluxo de trabalho que a utilizam:
- Tabela criada por — etapas que gravam na tabela
- Tabela contribui para — etapas que leem dela
- Pode referenciar esta tabela — etapas que alcançam uma tabela por meio de uma variável que não pode ser resolvida. Esta seção só aparece quando há tais etapas.
Selecionar outra tabela limpa essas listas imediatamente. Uma etapa de outro projeto que compartilha os dados deste projeto, como uma etapa Importar: Tabela de projeto externa que lê esta tabela, também é listada, sem o nome nem o fluxo de trabalho, porque você pode não ter acesso a esse projeto. Essas etapas podem aparecer um instante depois das demais.
Uma etapa pode citar uma tabela diretamente ou alcançá-la por um caminho que contém uma variável, como /Periods/{period}/Sales. Quando essa variável tem um valor atual, a etapa aparece nas duas primeiras listas com um ícone de informação ao lado. Passe o mouse sobre a linha para ver o caminho como a etapa o armazena.
Trate essas linhas como a resposta mais fraca que são. Elas descrevem o que uma execução iniciada agora usaria — não tudo o que já usou a tabela. Altere a variável e uma tabela diferente será lida.
Algumas variáveis não podem ser resolvidas. Ou nada definiu a variável, ou o valor que uma execução usa não vem do que está armazenado — um Workflow Loop obtém suas variáveis dos dados à medida que itera, uma etapa Set Variable atribui durante a execução, uma macro recebe suas variáveis da etapa que a chama e uma execução iniciada por um sensor carrega os detalhes do próprio sensor. Em cada caso, o que está armazenado entre execuções é um resíduo da última, e não um valor confiável. Em vez de resolver essas variáveis para uma tabela que pode estar errada, o PlaidCloud lista as etapas pelo nome em Pode referenciar esta tabela, com a variável que não conseguiu resolver, para que você possa abri-las e conferir.
Uma etapa que sua função não pode ver ainda é listada, para que você saiba que a tabela está em uso, mas sem o nome nem o fluxo de trabalho, e você não pode abri-la. Ela ainda conta quando você exclui a tabela. Uma etapa que você pode ver é listada sem qualquer fluxo de trabalho que sua função oculte. Nada fica oculto de um Arquiteto.
Observação: quando você exclui tabelas da lista Tabelas, uma etapa que alcança uma tabela por um caminho, com ou sem variável, conta como a utilizando, mesmo quando sua variável não pode ser resolvida. A janela de exclusão lista a etapa, e a exclusão só prossegue se você forçá-la.
Criar uma nova estrutura de diretórios
Seção intitulada “Criar uma nova estrutura de diretórios”Para adicionar uma nova pasta:
- Clique no botão Nova pasta na barra de ferramentas
Para adicionar uma pasta a uma pasta existente:
- Clique com o botão direito na pasta
- Selecione Nova pasta
Quando a seleção está dentro de uma pasta, a caixa de diálogo em que você informa o nome da nova pasta também tem Criar no nível superior. Marque essa opção para colocar a nova pasta no nível superior do projeto.
Ver dados (Explorador de tabelas)
Seção intitulada “Ver dados (Explorador de tabelas)”Os dados da tabela são vistos usando o Explorador de tabelas. O Explorador de tabelas oferece uma visão em grade dos dados, além de um resumo de valores e estatísticas coluna por coluna. A filtragem de apontar e clicar e a exportação para formatos de arquivo conhecidos estão disponíveis. As seleções de filtro também podem ser salvas como uma etapa Extract utilizável em um fluxo de trabalho.
Publicar tabela para relatórios
Seção intitulada “Publicar tabela para relatórios”As visualizações de painéis são propositalmente limitadas a tabelas que foram publicadas. Ao publicar uma tabela, você pode fornecer um nome exclusivo que pode distinguir os dados. Isso pode ser útil quando a tabela tem um nome mais obscuro na parte do fluxo de trabalho que a gerou, mas precisa de um nome mais claro para quem cria painéis.
As tabelas publicadas não têm caminhos associados a elas. Elas aparecem como uma lista de tabelas para uso na área de painéis.
Marcar tabela para funções de visualização
Seção intitulada “Marcar tabela para funções de visualização”A visualização das tabelas por diferentes funções pode ser controlada clicando nas caixas de seleção Explorador ou Gerente. Se várias tabelas precisarem ser atualizadas, selecione as tabelas na hierarquia e selecione a função de visualização desejada no menu Ações da barra de ferramentas superior.
Memorandos para descrever o conteúdo da tabela
Seção intitulada “Memorandos para descrever o conteúdo da tabela”Adicione um memorando a uma tabela para ajudar a entender os dados.
Ver formato, tamanho e hora da última atualização da tabela
Seção intitulada “Ver formato, tamanho e hora da última atualização da tabela”O número de linhas, colunas e o tamanho dos dados de cada tabela são mostrados na hierarquia de tabelas. Para tabelas muito grandes (vários milhões de linhas), a contagem de linhas pode ser estimada, e será mostrado um indicador de contagem aproximada de linhas.
Ver atributos adicionais da tabela
Seção intitulada “Ver atributos adicionais da tabela”Para ver e editar outros atributos da tabela:
- Selecione uma tabela
- Clique para ver o formulário de contexto da tabela à direita.
Duplicar uma tabela
Seção intitulada “Duplicar uma tabela”Para duplicar uma tabela:
- Selecione a tabela
- Clique no botão de duplicar na barra de ferramentas superior.
Criar um aplicativo Panel a partir de uma tabela
Seção intitulada “Criar um aplicativo Panel a partir de uma tabela”Selecione uma tabela ou visão e escolha Criar aplicativo Panel no menu Novo ou no menu de clique com o botão direito. A caixa de diálogo Novo aplicativo Studio abre com o projeto e a tabela já escolhidos. O aplicativo recebe o nome da tabela; altere-o se quiser, depois escolha Criar, e o Panel Studio o abre com o Weave pronto para criar a primeira página. O comando está disponível quando você seleciona uma única tabela ou visão, tem acesso de edição ao projeto e o projeto não é somente leitura. Consulte Criar um aplicativo Panel.
Ver o que as tabelas armazenam
Seção intitulada “Ver o que as tabelas armazenam”A lista Tabelas mostra as colunas Dados atuais, Histórico, Dias de Time Travel e Observação ao lado do tamanho de cada tabela. Dias de Time Travel é a configuração da própria tabela; 1 significa que ela usa o padrão do projeto. A barra de status abaixo da lista mostra o total do projeto: quanto ele armazena e quanto disso são dados atuais e quanto é histórico. Os tamanhos marcados como Estimado vêm do formato da tabela até que o PlaidCloud o meça.
Escolha Armazenamento no menu Ações para abrir a janela Armazenamento do projeto, com sugestões para liberar espaço e as configurações de time travel. Consulte Gerenciar o armazenamento.
Criar um editor de dados a partir de uma tabela
Seção intitulada “Criar um editor de dados a partir de uma tabela”Você pode transformar uma tabela em um editor de dados configurado em uma única etapa — selecione a tabela e escolha Criar editor de dados a partir da tabela no menu Novo ou no menu de clique com o botão direito. O PlaidCloud examina as colunas da tabela e pré-cria os controles de entrada do editor. Consulte Criar um editor de dados a partir de uma tabela para ver os detalhes.