Gerenciar projetos

Pesquisar

A pesquisa de projetos é feita na caixa de filtro, no canto inferior esquerdo da hierarquia. O filtro de pesquisa procura correspondências nos nomes e nos rótulos dos projetos e mostra os resultados na hierarquia acima.

Criar novos projetos

Para criar um novo projeto:

Abra o Analyze
Selecione “Projetos” na barra de menus superior
Clique no botão “Novo projeto”
Preencha as informações do formulário, incluindo a seção “Controle de acesso”
Clique em “Criar”

O projeto agora está pronto para você atualizar as permissões de acesso, adicionar proprietários e criar fluxos de trabalho.

Definir uma conta de documentos padrão

Na página inicial do projeto, ao lado de Ambiente da conexão, escolha uma Conta de documentos padrão para o projeto, ou Nenhum para limpá-la.

Dentro do projeto, todo seletor de arquivos lista Project Default em primeiro lugar, representando a conta que o projeto tem definida no momento. Ele sai da lista quando você deixa o projeto, quando o projeto não tem padrão definido, quando essa conta foi excluída ou quando você perde o acesso a ela.

Uma nova etapa de arquivo pré-seleciona Project Default quando o projeto tem um. As etapas existentes nunca são reescritas: cada uma mantém a conta com que foi salva até você mudá-la, pois uma conta de documentos é uma escolha por etapa, de uma forma que o ambiente da conexão não é.

Uma etapa deixada em Project Default é resolvida para a conta que for o padrão do projeto quando ela é executada, então mudar o padrão no meio de uma execução afeta apenas os nós que ainda não começaram, o mesmo que ocorre ao mudar o ambiente da conexão. Se uma etapa é executada em Project Default e o projeto não tem padrão definido, a execução falha e nomeia o projeto, em vez de recorrer a outra conta.

Histórico de versões

Todo objeto de um projeto (uma etapa, uma UDF, um fluxo de trabalho, uma dimensão, um layout salvo, um documento ou editor de dados e as próprias configurações do projeto) é coberto por backups do histórico de versões. Um backup não é feito a cada salvamento individual; em vez disso, quando um objeto fica 30 segundos sem outro salvamento, é feito um backup do seu estado estabilizado. Uma sequência de edições (vários salvamentos em rápida sucessão) produz uma única versão com o resultado final, e não uma versão por salvamento. O salvamento nunca fica mais lento esperando um backup: a contagem regressiva e o próprio backup são executados em segundo plano. Se você precisa de uma versão agora mesmo, use Back up now para capturar o estado atual imediatamente e aguardar a conclusão; a opção está disponível na interface, na API e como a ação backup do MCP *_versions. O histórico de versões está disponível em todos os planos, inclusive no Free.

As versões anteriores permitem a recuperação para um ponto no tempo: restaure um objeto para uma versão anterior. A restauração é recusada dentro de um projeto bloqueado, como qualquer outra alteração ali.

Uma versão é restaurada no próprio lugar. Restaurar uma versão de um projeto, dimensão, função definida pelo usuário, etapa, fluxo de trabalho ou editor de dados substitui esse mesmo item, e indicar outro item como destino é recusado, por exemplo: “A project version is restored in place. Leave the target out, or set it to this project.” Restaurar é uma alteração no item, portanto exige a mesma função necessária para editá-lo; em um projeto que restringe linhas, restaurar o projeto ou uma dimensão lida por uma coluna restrita exige um Arquiteto do projeto. Para trazer dados antigos de tabela de volta como uma tabela separada, restaure um instantâneo de tabela para uma nova tabela.

Além desse acompanhamento automático, os projetos e seus elementos também permitem versionamento. Criar uma versão é fácil e você também pode mesclar alterações de uma versão em outra. Isso oferece uma forma simples de acompanhar instantâneos ou de criar uma versão para desenvolvimento e depois mesclar essas alterações na versão que não é de desenvolvimento quando quiser. Consulte Colaborar: versões, comparação e compartilhamento para ver versionamento, comparação e mesclagem na prática.

Os dados das tabelas têm seu próprio histórico (instantâneos feitos pelo Lakehouse a cada gravação), descrito em Instantâneos de tabela.

Restaurar e reter pelo assistente de IA ou pelo MCP

Pelo assistente de IA ou pelo MCP, dimension_versions restaura, retém e libera uma versão de dimensão pelo respectivo version_id, e restore_project reverte todas as dimensões do projeto para o último backup; além disso, toda listagem *_versions (etapas, UDFs, fluxos de trabalho, dimensões, projetos) mostra o version_id de cada versão e se ela está retida. Um restore por qualquer ferramenta *_versions, ou pela API REST, restaura o item no próprio lugar: omita o destino ou defina-o como o próprio item. project_upsert pode desbloquear um projeto bloqueado e respeita if_match, de modo que falha em vez de sobrescrever uma alteração feita desde a última vez que você leu o projeto.

Gerenciar o acesso ao projeto

Tipos de acesso

A segurança do projeto foi simplificada em três tipos de acesso:

Todos os membros do espaço de trabalho
Somente membros específicos
Somente grupos de segurança específicos

Definir a segurança do projeto é fácil:

Abra o Analyze
Selecione “Projetos”
Clique no ícone de edição do projeto que você quer restringir
Escolha a restrição desejada em “Controle de acesso”
Clique em “Atualizar”

Somente um Arquiteto do projeto ou um administrador do tenant pode alterar quem tem acesso a um projeto: o tipo de acesso, os membros e os grupos de segurança nele e seus compartilhamentos de dados. Qualquer outra pessoa vê esses painéis somente para leitura, com a observação “Only project Architects can change access.”

Todos os membros do espaço de trabalho

O acesso “Todos os membros do espaço de trabalho” é a opção mais simples, pois dá acesso a todos os membros do espaço de trabalho e não exige nenhuma atribuição adicional de membros.

Somente membros específicos

A configuração de acesso “Somente membros específicos” exige a atribuição de cada membro ao projeto. Para atribuir membros a um projeto:

Abra o Analyze
Selecione “Projetos” na barra de menus superior
Clique no ícone de membros
Conceda acesso aos membros marcando a caixa de seleção ao lado do nome deles na coluna “Acesso”
Clique em “Atualizar”

Para clouds com grande número de membros, essa abordagem muitas vezes exige mais esforço do que o desejado, e é aí que os grupos de segurança se tornam úteis.

Somente grupos de segurança específicos

A opção “Somente grupos de segurança específicos” permite atribuir a grupos de segurança específicos a permissão para acessar a conta. Com as restrições de acesso baseadas na associação a um ou mais grupos de segurança, a administração do acesso à conta para grupos maiores fica muito mais simples. Isso é particularmente útil quando combinado com a associação automática de grupos por login único. Ao usar o login único para definir as atribuições de grupo dos membros, esses grupos também podem ativar e desativar o acesso aos projetos de forma implícita.

Para editar os grupos atribuídos:

Abra o Analyze
Selecione “Projetos” na barra de menus superior
Clique no ícone de grupos de segurança
Conceda acesso aos grupos de segurança marcando a caixa de seleção ao lado do nome deles na coluna “Acesso”
Clique em “Atualizar”

Compartilhar dados entre projetos

Um compartilhamento de dados permite que um projeto acesse as tabelas de outro projeto, por exemplo, para que as etapas Import Project Table e Export Project Table possam mover dados entre eles. Um compartilhamento é concedido pelo projeto cujos dados são compartilhados, a um outro projeto:

Abra o projeto cujos dados você quer compartilhar e vá para a guia Início.
Em Gerenciamento de compartilhamento de dados, clique em Novo compartilhamento de dados.
Em Selecionar projeto, escolha o projeto que pode usar os dados deste projeto.
Em Operações permitidas, marque Leitura, Gravação ou ambas e clique em Adicionar compartilhamento de dados.

Excluir compartilhamento de dados remove um compartilhamento. Somente um Arquiteto do projeto ou um administrador do tenant pode adicionar ou excluir os compartilhamentos de dados de um projeto.

Um compartilhamento é concedido a um projeto, portanto vale apenas para os membros e os fluxos de trabalho desse projeto:

Ler por meio de um compartilhamento exige uma função no projeto ao qual ele foi concedido. Quem não tem função ali não obtém nada do compartilhamento.
Gravar por meio de um compartilhamento (criar uma tabela, uma pasta ou uma dimensão no projeto que compartilha) exige um compartilhamento de Gravação e a função Gerente ou Arquiteto no seu próprio projeto, a função que poderia fazer a mesma alteração ali. Qualquer outra pessoa recebe a mensagem “Writing to this project through a data share needs a write share from it to your project, and the Manager or Architect role in your project.”

Os fluxos de trabalho são executados com a identidade do próprio projeto, então as etapas Import Project Table e Export Project Table funcionam por meio de um compartilhamento, seja quem for que inicie a execução.

Definir diferentes funções de visualização

Muitas vezes um projeto pode exigir várias transformações e tabelas para concluir etapas intermediárias, enquanto o resultado final pode acabar consistindo em apenas algumas tabelas. Os membros nem sempre precisam ver todos os elementos do projeto, às vezes apenas o produto final. O PlaidCloud permite definir diferentes funções de visualização para simplificar e controlar facilmente a visibilidade de cada membro.

Há três funções de visualização integradas: Arquiteto, Gerente e Explorador

A função Arquiteto é a mais simples, pois permite visibilidade e controle totais de projetos, fluxos de trabalho, tabelas, variáveis, editores de dados, hierarquias e funções definidas pelo usuário.

As funções Gerente e Explorador não têm privilégios de acesso específicos, mas podem ser definidas de forma personalizada. Em outras palavras, você pode escolher quais itens são visíveis para cada grupo.

Você pode tornar todos Arquitetos se achar necessária a visibilidade de tudo dentro do projeto; caso contrário, você pode designar membros como membros Gerente e/ou Explorador do projeto e controlar a visibilidade dessa forma.

Para definir a função:

Abra o Analyze
Selecione “Projetos”
Clique no ícone de membros
Selecione o membro cuja função você quer alterar
Clique duas vezes na função atual dele na coluna “Função”
Selecione a função desejada
Clique em “Atualizar”

Gerenciar variáveis do projeto

Ao executar um projeto ou fluxo de trabalho, pode ser útil definir variáveis para tarefas recorrentes, a fim de reduzir a desordem e economizar tempo. Essas variáveis funcionam exatamente como uma variável algébrica comum, permitindo definir o que a variável representa e qual operação deve segui-la. O PlaidCloud permite definir essas variáveis no nível do projeto, o que afeta todos os fluxos de trabalho desse projeto, ou no nível do fluxo de trabalho, o que afeta apenas aquele fluxo de trabalho específico.

Para definir uma variável no nível do projeto:

Abra o Analyze
Selecione “Projetos”
Clique no ícone Gerenciar variáveis do projeto

Na tabela de variáveis, você pode ver as variáveis e ver/editar os valores atuais. Você também pode adicionar novas variáveis ou excluir as existentes clicando no botão “Nova variável do projeto”.

Copiar um projeto

Copiar projeto copia um projeto, inteiro ou apenas as partes que você escolher, para um projeto totalmente novo ou para um projeto que já existe.

Para copiar um projeto:

Abra o Analyze
Selecione “Projetos”
Selecione o projeto que você quer copiar
Clique no botão Ações e escolha Copiar projeto
Escolha o destino, selecione o que levar e quantos dados, e clique em Copiar projeto
Confira o resumo Revisar antes de copiar e clique em Iniciar cópia

Escolher o que copiar

A árvore de seleção lista o que o projeto contém, por tipo: fluxos de trabalho, etapas, tabelas, dimensões, editores de dados e funções definidas pelo usuário. Deixe tudo marcado para copiar o projeto inteiro ou marque apenas as partes que você quer.

Você não precisa descobrir do que essas partes dependem. Tudo o que você marca leva suas dependências junto: as tabelas que uma etapa lê e grava, as dimensões que ela carrega ou nas quais aloca, as funções definidas pelo usuário que ela chama e qualquer subfluxo de trabalho ou macro que ela invoca. Os sensores de um fluxo de trabalho acompanham o fluxo de trabalho.

Os sensores copiados chegam desativados. Nada é disparado na cópia até você ativar cada sensor no projeto de destino. Uma importação que substitui itens duplicados não adiciona um segundo sensor quando o fluxo de trabalho de destino já o tem.

Copiar para um novo projeto

Dê ao novo projeto um nome e um ID. O ID se torna o nome do esquema dele e não pode ser alterado depois.

Os agendamentos chegam pausados. Quando você copia um projeto inteiro para um novo, os eventos agendados de cada fluxo de trabalho vêm pausados, para que a cópia não comece a executá-los por conta própria. Quando a cópia termina, uma mensagem lista os eventos que estavam ativos no original. Para executar um deles na cópia, selecione-o em Ferramentas > Agendador de eventos e clique em Ativar selecionados; consulte Pausar um evento.

Copiar para um projeto existente

Escolha o destino na lista de projetos. A cópia é adicionada a esse projeto, em vez de substituí-lo.

Você precisa poder alterar o destino. Uma cópia para um projeto em que você não tem nenhuma função é recusada, assim como uma cópia para um projeto que foi bloqueado para impedir alterações; isso é verificado antes de qualquer leitura ou gravação, de modo que uma cópia recusada deixa o destino intacto. Um projeto também não pode ser copiado para ele mesmo.

Copiar um projeto que restringe linhas exige um Arquiteto do projeto. A cópia é um novo projeto sem restrição de acesso a linhas, e a cópia avisa isso: “This copy is not row-restricted.” Configure o Acesso a linhas na cópia antes de compartilhá-la. Copiar para um projeto existente que restringe linhas exige igualmente um de seus Arquitetos ou um administrador do tenant.

O destino mantém as próprias configurações. O nome, o ID, o ambiente de conexão de dados, os padrões de armazenamento, a conta de documentos, o tipo de acesso, as listas de acesso e as concessões de acesso a linhas permanecem como estão. Apenas o conteúdo que você selecionou é trazido.

Uma etapa definida como Project Default leva essa configuração, não uma conta; depois de copiada, ela é resolvida para o padrão que o projeto de destino tiver, não para o que tinha na origem.

Quando um item recebido é o mesmo item que já está no destino, você escolhe o que acontece:

Substituir itens duplicados pelos dados recebidos — a versão recebida substitui a que está no destino.
Criar nova cópia dos itens duplicados — o destino mantém o que tem, e o item recebido é adicionado ao lado dele com copy acrescentado ao nome, e um contador se esse nome também estiver em uso.

As variáveis de projeto e de fluxo de trabalho são a exceção de Criar nova cópia: uma variável é identificada pelo nome, então não há como adicionar uma segunda cópia dela sem renomeá-la para algo a que nada se refere. Quando o destino já define uma variável que a cópia também traz, o valor do próprio destino é mantido, e a cópia informa quais variáveis deixou intactas. Substituir trata as variáveis como todo o resto e as substitui.

Essa correspondência é por identidade, não por nome: um item que veio originalmente do mesmo projeto é reconhecido como o mesmo item, enquanto dois itens que apenas têm o mesmo nome são tratados como itens diferentes e ambos estarão presentes depois.

Escolher quantos dados copiar

Modo	O que é copiado
Somente estrutura	Tabelas, etapas e o restante da seleção, sem linhas.
Dados completos	As linhas de todas as tabelas, no mesmo lakehouse e entre lakehouses.
Amostra	Até o número de linhas que você informar de cada tabela, somente para um novo projeto. O número pode ser de 1 a 1.000.000.

Uma tabela amostrada contém até esse número de linhas, ou todas as suas linhas quando tem menos.

Revisar a cópia

Antes de qualquer coisa ser copiada, Revisar antes de copiar resume a cópia: o projeto de origem, o destino, o modo de dados, o número de tabelas e visões, o tamanho, uma estimativa de tempo, o lakehouse de origem e de destino e quaisquer avisos em Observação. Clique em Iniciar cópia para começar ou em Cancelar para voltar e alterar a seleção.

Quem pode ver a cópia

Uma cópia feita com dados é privada para a pessoa que a fez. Compartilhe-a a partir do novo projeto quando estiver pronto. Uma cópia de um projeto com segurança em nível de linha continua privada pelo mesmo motivo.

Copiar dados para um projeto existente exige acesso de gravação a esse projeto.

Resultados da cópia

Quando a cópia termina, uma janela Resultados da cópia lista o resultado de cada tabela por nome, com o motivo de qualquer tabela que tenha falhado. Clique em Tentar novamente as tabelas com falha para copiar apenas essas tabelas de novo; o conteúdo de uma tabela repetida é substituído. Você é notificado, por mensagem e por e-mail, quando uma cópia termina ou falha, e pode reabrir os resultados pela mensagem ou, mais tarde, selecionando a cópia na guia Projetos e escolhendo Ver resultado da importação ou cópia no menu Ações.

Os resultados permanecem na cópia até alguém dispensá-los. Depois que a cópia termina, clique em Dispensar resultado para removê-los para todos que podem abrir o projeto. Nada no projeto muda, mas as tabelas com falha não podem mais ser repetidas pela janela. Dispensar exige acesso de edição ao projeto, e o projeto não pode estar bloqueado.

Atualizar referências

As etapas de fluxo de trabalho de um projeto se referem a tabelas e outros objetos dentro desse projeto. Atualizar referências reescreve essas referências para que apontem para a cópia, e não para o original, que é quase sempre o que você quer e por isso vem ativado por padrão. Desativá-lo deixa as etapas copiadas apontando de volta para o projeto de onde vieram.

Visualizar o relatório do projeto

Quando um projeto ou fluxo de trabalho é dinâmico, manter uma documentação detalhada se torna um desafio. Para ajudar a resolver esse problema, o PlaidCloud permite gerar um relatório no nível do projeto que traz uma documentação detalhada de fluxos de trabalho, etapas de fluxo de trabalho, transformações definidas pelo usuário, variáveis e tabelas. Esse relatório é gerado sob demanda e reflete o estado atual do projeto.

Para baixar o relatório:

Abra o Analyze
Selecione “Projetos”
Clique no ícone de relatório