Gerir tabelas e vistas
O PlaidCloud permite organizar e gerir tabelas, incluindo etiquetas. As tabelas estão disponíveis para todos os fluxos de trabalho de um projeto e dispõem de muitas ferramentas e opções.
Além das tabelas, o PlaidCloud também oferece Vistas baseadas nos dados das tabelas. A utilização de Vistas permite atualizações instantâneas quando ocorrem alterações nas tabelas subjacentes, além de poupar 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 ser etiquetadas 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 Visualizações de painéis de controlo
O PlaidCloud utiliza um sistema baseado em caminhos para organizar as tabelas, tal como se navega por uma série de pastas, o que permite uma organização mais flexível e lógica das tabelas. Com este 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 diferentes locais da hierarquia (hierarquias alternativas). A capacidade de gerir tabelas com este método permite que a estrutura reflita as necessidades operacionais, de relato e de controlo.
Encontrar tabelas
Seção intitulada “Encontrar tabelas”Utilize Filtro na parte inferior da lista, junto à contagem de linhas, para pesquisar nomes e etiquetas de tabelas. Prima / ou Ctrl/Cmd+F para ir diretamente para ele. O mesmo filtro aplica-se à árvore e à lista simplificada. O seletor Todos | Publicado junto ao filtro limita a lista às tabelas publicadas; está definido como Todos por predefinição e aplica-se tanto à árvore como à lista simples.
Por fluxo de trabalho
Seção intitulada “Por fluxo de trabalho”A pasta Por fluxo de trabalho no final do separador Tabelas agrupa as tabelas sob cada fluxo de trabalho que as lê ou escreve. Abra um fluxo de trabalho para ver as suas tabelas. A pasta é uma vista das mesmas tabelas, pelo que não pode mover nem copiar nada a partir dela.
Por coluna
Seção intitulada “Por coluna”Selecione Procurar coluna na barra de ferramentas do separador Tabelas para encontrar as tabelas que têm uma coluna com um determinado nome. A pesquisa lê os nomes das colunas, não os dados, pelo que é rápida, e só encontra tabelas que já foram criadas. A janela abre na última pesquisa que executou nesse projeto desde que abriu o projeto, se tiver executado alguma.
Escreva pelo menos dois carateres e os resultados são atualizados à medida que escreve, ou prima Enter para pesquisar de imediato. Quando os resultados do que escreveu estiverem a ser apresentados, Enter na caixa de pesquisa seleciona a tabela realçada, tal como numa linha. Escolha como o nome é correspondido:
- Exato — o nome completo da coluna, sem distinguir maiúsculas de minúsculas
- Contém — parte do nome da coluna, sem distinguir maiúsculas de minúsculas. Esta é a predefinição.
- Aproximado — nomes parecidos, ignorando maiúsculas e minúsculas, espaços, carateres de sublinhado e outros separadores, e tolerando pequenos erros de escrita. As correspondências mais próximas vêm primeiro.
A janela memoriza a correspondência que escolheu por último nesse navegador. Enquanto a caixa de pesquisa está vazia, lista as suas últimas cinco pesquisas no projeto nesse navegador; selecione uma para a executar novamente. Uma pesquisa conta como executada e entra na lista quando prime Enter, a seleciona na lista ou atua sobre os respetivos resultados.
Cada tabela correspondente ocupa uma linha, com o seu nome, o seu caminho e as três primeiras colunas correspondentes. A linha acima dos resultados conta as tabelas encontradas até ao momento enquanto a pesquisa decorre. Quando nada corresponde com Exato ou Contém, selecione Tentar Aproximado? para pesquisar novamente com Aproximado. 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 indicam que podem estar incompletos.
Quando os resultados incluem mais do que um nome de coluna, chips acima da lista indicam até 12 deles, os mais comuns primeiro, cada um com o número de tabelas que o têm. Selecione um chip para listar apenas as tabelas com essa coluna e selecione-o novamente para as listar todas.
Expanda uma linha para ver:
- Colunas correspondentes — cada coluna correspondente, com o seu tipo quando este é texto, inteiro, número, data, timestamp ou booleano. Uma coluna apresentada na cor de aviso tem um tipo diferente noutras tabelas dos resultados; passe o rato sobre ela para ver os tipos.
- Alimentada por — as tabelas lidas pelos passos que gravam esta tabela, cada uma com o nome do passo
- Alimenta — as tabelas gravadas pelos passos que leem esta tabela, cada uma com o nome do passo
Só são listados os passos do mesmo projeto.
Para atuar sobre os resultados:
- Faça duplo clique numa linha, ou prima Enter sobre ela, para fechar a janela e selecionar essa tabela no separador Tabelas. Se uma pesquisa de colunas apresentada na árvore ou o seletor Todos | Publicado ocultar a tabela, é limpo e uma mensagem avisa-o. Prima Ctrl+Enter, ou Cmd+Enter num Mac, para abrir a tabela no Explorador de tabelas. As teclas de seta para cima e para baixo na caixa de pesquisa movem-se 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 indica a pesquisa e conta as respetivas tabelas. Selecione o chip para abrir a pesquisa novamente, ou o × nele para mostrar todas as tabelas. Atualizar o separador 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 respetivos tipos 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 ligado através do MCP encontra as mesmas tabelas com table_find(column=...). Faz corresponder o nome completo, parte dele, o início ou o fim, ou nomes parecidos com column_match='fuzzy', e devolve os tipos das colunas correspondentes e, numa correspondência aproximada, quão próxima é a melhor coluna.
Pesquisar valores
Seção intitulada “Pesquisar valores”Para descobrir que tabelas contêm um valor, escolha Pesquisar valores nos dados… (lento) no menu Ações do separador Tabelas, ou clique com o botão direito do rato numa tabela e escolha-o para procurar apenas nessa tabela. Introduza 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 aparece e alguns dos valores correspondentes. Faça duplo clique numa tabela, ou prima Enter sobre ela, para a abrir no Explorador de tabelas. Uma coluna abre a tabela filtrada pelas linhas correspondentes.
Antes de pesquisar, tenha em atenção que:
- A pesquisa lê todas as linhas de todas as tabelas pesquisadas, pelo que pode ser muito lenta e utilizar muitos recursos do armazém de dados. A janela avisa-o e os botões de pesquisa permanecem desativados até uma pesquisa terminar.
- Só vê linhas que já poderia abrir. A segurança ao nível da linha aplica-se a todas as pesquisas.
- O histórico de consultas do seu armazém de dados regista os valores que pesquisa.
- A pesquisa abrange as colunas de texto das tabelas. As tabelas que não foram criadas são ignoradas e indicadas num aviso.
- Os resultados chegam em páginas. Quando a linha de estado indica que a pesquisa parou antes do fim, escolha Pesquisar mais para continuar com as tabelas ainda não pesquisadas.
Um assistente de IA ligado através do MCP utiliza table_value_search. Devolve as tabelas e as colunas que contêm o valor, nunca os próprios valores. Quando pede ao assistente de IA num projeto que encontre um valor, o Weave envia os nomes das tabelas e das colunas correspondentes ao fornecedor do modelo de linguagem.
Importar um ficheiro CSV
Seção intitulada “Importar um ficheiro CSV”Para transformar um ficheiro CSV numa nova tabela neste projeto:
- Arraste o ficheiro do seu computador para a lista Tabelas do projeto, ou escolha Novo > Tabela a partir de ficheiro CSV na barra de ferramentas e largue o ficheiro na caixa ou clique em Escolher um ficheiro CSV.
- O PlaidCloud carrega o ficheiro para a sua Personal Temp Drive, ou para a Temp Drive da área de trabalho se não tiver uma, e importa-o para uma nova tabela no nível superior da lista, com o nome do ficheiro:
Sales Data.csvpassa asales_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 Os seus dados num relance abre-se sobre ela. Consulte Comece com o seu próprio CSV para ver o que o painel mostra.
Só são aceites ficheiros terminados em .csv. É necessária permissão para criar tabelas e para escrever no armazenamento de documentos, e um projeto bloqueado não aceita um CSV até ser desbloqueado. Se a importação falhar, a janela indica o motivo e o projeto fica como estava. O PlaidCloud elimina o ficheiro carregado da unidade temporária assim que a importação termina, tenha ou não tido êxito; se tal não acontecer, a unidade temporária elimina-o ao fim de um dia.
Para mover uma tabela:
- Arraste-a para a pasta onde pretende que fique localizada
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 pastas, / é o nível superior do projeto.
Mudar o nome
Seção intitulada “Mudar o nome”Para mudar o nome de uma tabela:
- Clique com o botão direito do rato na tabela
- Selecione a opção de mudar o nome
- Escreva o novo nome e guarde-o
- A tabela passa a ter o novo nome, mas mantém o identificador único original.
Para limpar uma tabela:
- Selecione as tabelas na hierarquia ‘
- Clique no botão de limpar na barra de ferramentas superior.
Nota: pode limpar uma única tabela ou várias tabelas
Eliminar
Seção intitulada “Eliminar”Para eliminar uma tabela:
- Selecione as tabelas na hierarquia
- Clique no botão de eliminar na barra de ferramentas superior
- A operação de eliminação verifica se a tabela está a ser utilizada por passos de fluxos de trabalho ou Vistas. Se estiver, é-lhe pedido que remova essas associações antes de a eliminação poder ocorrer.
Nota: também pode forçar a eliminação da(s) tabela(s). A eliminação forçada da(s) tabela(s) deixa as referências quebradas, pelo que deve ser utilizada com moderação.
Última leitura
Seção intitulada “Última leitura”A janela de eliminação mostra quando a tabela foi lida pela última vez, por exemplo Last read 3 days ago by uma pessoa ou um passo, para que possa distinguir uma tabela que ninguém utiliza de uma que ainda está em utilização. O PlaidCloud obtém esta informação do histórico de consultas do próprio armazém de dados e exclui as leituras feitas pelas suas próprias tarefas de manutenção.
| Armazém de dados | O que é necessário |
|---|---|
| Snowflake | As leituras provêm do Access History, que o Snowflake regista com um atraso de até cerca de 3 horas. A função da ligação precisa da função de base de dados SNOWFLAKE.GOVERNANCE_VIEWER (IMPORTED PRIVILEGES na base de dados SNOWFLAKE também funciona). A edição Standard do Snowflake não tem Access History. |
| Databricks | As leituras provêm da tabela de linhagem, que o Databricks também regista com atraso, pelo que uma leitura recente pode ainda não aparecer. A identidade da ligaçã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 liga o seu armazém de dados, a verificação da ligação recomenda quaisquer destas permissões que estejam em falta, cada uma com a instrução a executar. São recomendadas, não obrigatórias: sem elas, o armazém de dados liga-se e a janela mostra Read history incomplete.
Quando o PlaidCloud não consegue ler o histórico completo, a linha indica Read history incomplete e nunca comunica “sem leituras” em seu lugar. Qualquer pessoa com acesso SQL direto ao seu armazém de dados pode definir uma etiqueta de sessão que altera a forma como as suas próprias leituras são identificadas.
Um assistente de IA ligado através do MCP obtém a mesma resposta a partir 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 o respetivo painel de detalhes. A sua secção Colunas lista cada coluna com o respetivo Tipo e Descrição, vindo a descrição de Propriedades da coluna. Aponte para uma linha para ler uma descrição longa na íntegra.
Uma tabela que não está atualmente no armazém de dados, porque os seus dados expiraram ou nenhum passo a criou, não tem colunas para listar. A secção indica-o e mostra quantas colunas a tabela tem. Execute um passo que escreva a tabela para listar as colunas.
Ver onde uma tabela é utilizada
Seção intitulada “Ver onde uma tabela é utilizada”Selecionar uma tabela abre o respetivo painel de detalhes, que lista os passos de fluxo de trabalho que lhe tocam:
- Tabela criada por — passos que escrevem na tabela
- A tabela contribui para — passos que leem dela
- Pode referenciar esta tabela — passos que acedem a uma tabela através de uma variável que não pode ser resolvida. Esta secção só aparece quando existem tais passos.
Selecionar outra tabela limpa imediatamente estas listas. Um passo de outro projeto que partilha os dados deste projeto, como um passo Importar: Tabela de projeto externa que lê esta tabela, também é listado, sem o respetivo nome ou fluxo de trabalho, porque pode não ter acesso a esse projeto. Esses passos podem aparecer um momento depois dos restantes.
Um passo pode indicar uma tabela diretamente ou aceder-lhe através de um caminho que contém uma variável, como /Periods/{period}/Sales. Quando essa variável tem um valor atual, o passo aparece nas duas primeiras listas com um ícone de informação junto a si. Passe o rato sobre a linha para ver o caminho tal como o passo o guarda.
Trate essas linhas como a resposta mais fraca que são. Descrevem o que uma execução iniciada agora tocaria — não tudo o que alguma vez tocou na tabela. Altere a variável e é lida uma tabela diferente.
Algumas variáveis não podem ser resolvidas. Ou nada definiu a variável, ou o valor que uma execução utiliza não provém do que está guardado — um passo Workflow Loop obtém as suas variáveis a partir dos dados à medida que itera, um passo Set Variable atribui durante a execução, uma macro recebe as suas variáveis de qualquer passo que a chame e uma execução iniciada por um sensor transporta os detalhes do próprio sensor. Em cada caso, o que está guardado entre execuções é um resto da última e não um valor de confiança. Em vez de resolver essas variáveis para uma tabela que pode ser a errada, o PlaidCloud lista os passos pelo nome em Pode referenciar esta tabela, com a variável que não conseguiu resolver, para que os possa abrir e verificar.
Um passo que a sua função não pode ver continua a ser listado, para que saiba que a tabela está em utilização, mas sem o respetivo nome ou fluxo de trabalho, e não o pode abrir. Continua a contar quando elimina a tabela. Um passo que pode ver é listado sem qualquer fluxo de trabalho que a sua função oculte. Nada é ocultado a um Arquiteto.
Nota: quando elimina tabelas da lista Tabelas, um passo que acede a uma tabela através de um caminho, com ou sem variável, conta como utilizador dela, mesmo quando a sua variável não pode ser resolvida. A janela de eliminação lista o passo e a eliminação só prossegue se a forçar.
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 do rato na pasta
- Selecione Nova pasta
Quando a seleção está dentro de uma pasta, a caixa onde indica o nome da nova pasta também tem Criar ao nível superior. Assinale-a para colocar a nova pasta ao nível superior do projeto.
Ver dados (Explorador de tabelas)
Seção intitulada “Ver dados (Explorador de tabelas)”Os dados das tabelas são vistos através do Explorador de dados. O Explorador de dados apresenta uma vista em grelha dos dados, bem como um resumo coluna a coluna dos valores e das estatísticas. Estão disponíveis a filtragem por apontar e clicar e a exportação para formatos de ficheiro comuns. As seleções de filtro também podem ser guardadas como um passo Extract utilizável num fluxo de trabalho.
Publicar uma tabela para relatórios
Seção intitulada “Publicar uma tabela para relatórios”As Visualizações de painéis de controlo estão intencionalmente limitadas a tabelas que foram publicadas. Ao publicar uma tabela, pode indicar um nome único que possa distinguir os dados. Isto pode ser útil quando a tabela tem um nome mais obscuro numa parte do fluxo de trabalho que a gerou, mas precisa de um nome mais claro para quem cria painéis de controlo.
As tabelas publicadas não têm caminhos associados. Aparecem como uma lista de tabelas para utilização na área de painéis de controlo.
Marcar uma tabela para funções de visualização
Seção intitulada “Marcar uma tabela para funções de visualização”A visualização de tabelas por várias funções pode ser controlada clicando nas caixas de verificação Explorador ou Gestor. Se for necessário atualizar várias tabelas, selecione as tabelas na hierarquia e selecione a função de visualização pretendida no menu Ações da barra de ferramentas superior.
Memorandos para descrever o conteúdo das tabelas
Seção intitulada “Memorandos para descrever o conteúdo das tabelas”Adicione um memorando a uma tabela para ajudar a compreender os dados.
Ver a forma, o tamanho e a hora da última atualização de uma tabela
Seção intitulada “Ver a forma, o tamanho e a hora da última atualização de uma tabela”O número de linhas, de colunas e o tamanho dos dados de cada tabela são apresentados na hierarquia de tabelas. Para tabelas muito grandes (milhões de linhas), a contagem de linhas pode ser estimada e é apresentado 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 Duplicar na barra de ferramentas superior.
Criar uma aplicação Panel a partir de uma tabela
Seção intitulada “Criar uma aplicação Panel a partir de uma tabela”Selecione uma tabela ou vista e escolha Criar aplicação Panel no menu Novo ou no menu de contexto. A caixa de diálogo Nova aplicação Studio abre-se com o projeto e a tabela já escolhidos. A aplicação assume o nome da tabela; altere-o se quiser, depois escolha Criar, e o Panel Studio abre-a com o Weave pronto a criar a primeira página. O comando está disponível quando seleciona uma única tabela ou vista, tem acesso de edição ao projeto e o projeto não é só de leitura. Consulte Criar uma aplicação 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 viagem no tempo e Nota junto ao tamanho de cada tabela. Dias de viagem no tempo é a definição própria da tabela; 1 significa que utiliza a predefinição do projeto. A barra de estado abaixo da lista indica o total do projeto: quanto armazena e quanto disso são dados atuais e quanto é histórico. Os tamanhos marcados como Estimado provêm da forma da tabela até o PlaidCloud os medir.
Escolha Armazenamento no menu Ações para abrir a janela Armazenamento do projeto, com sugestões para libertar espaço e as definições de time travel. Consulte Gerir 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”É possível transformar uma tabela num editor de dados configurado num único passo — selecione a tabela e escolha Criar editor de dados a partir da tabela no menu Novo ou no menu de contexto. O PlaidCloud examina as colunas da tabela e pré-constrói os controlos de entrada do editor. Consulte Criar um editor de dados a partir de uma tabela para mais detalhes.