Configuração do espaço de trabalho

A página Workspaces lista os espaços de trabalho do PlaidCloud que você pode gerenciar. Use-a para criar um espaço de trabalho, editar suas configurações, abri-lo, abrir painéis, abrir o console SQL, ver logs e métricas ou aplicar ações em lote aos espaços de trabalho selecionados.

Cuidado

Excluir remove o espaço de trabalho e os dados associados a ele. Confirme os backups e os requisitos de retenção antes de excluir um espaço de trabalho.

Lista de espaços de trabalho

A tabela de espaços de trabalho inclui nome, ID exclusivo, versão, canal de liberação, status, estado de pausa, data de criação, estado de provisionamento, cluster, dia de manutenção e horário de manutenção. A tabela oferece pesquisa, atualização, ações por linha e ações em lote.

As ações por linha disponíveis incluem:

Ação	Descrição
Ver	Abre os detalhes do espaço de trabalho somente para leitura.
Editar	Altera a configuração do espaço de trabalho.
Excluir	Exclui o espaço de trabalho.
Início	Abre o aplicativo do espaço de trabalho.
Painéis	Abre o serviço de painéis do espaço de trabalho.
SQL	Abre o console SQL do espaço de trabalho.
Logs e métricas	Abre os logs operacionais e as métricas do espaço de trabalho.

As quatro ações de serviço (Início, Painéis, SQL e Logs e métricas) aparecem apenas em um espaço de trabalho em execução e somente para os serviços que ele tem ativados. Um espaço de trabalho ainda em criação não mostra nenhum ícone de serviço, portanto não há link para clicar que não leve a lugar nenhum.

Status de provisionamento

Criar um espaço de trabalho leva vários minutos e, até terminar, ele existe, mas não pode ser aberto. As colunas Criado, Status e Provisioning informam em que ponto ele está, e a guia Provisioning na caixa de diálogo de detalhes do espaço de trabalho mostra as mesmas informações de um espaço de trabalho, junto com as URLs de serviço publicadas para ele no momento.

Coluna	O que ela informa
Criado	Quando o registro do espaço de trabalho foi criado. Também é quando sua primeira tentativa de provisionamento começou.
Status	A fase em que o provisionamento está, como activating. Um espaço de trabalho concluído mostra running.
Provisionamento	A fase resumida em uma palavra: provisioning, running, failed, paused, trashed ou deleting.

Um espaço de trabalho que permanece na mesma fase por mais de cerca de meia hora travou, e um que mostra failed parou. De qualquer forma, entre em contato com o suporte do PlaidCloud informando o ID do espaço de trabalho e a fase exibida: o detalhe do que falhou cita componentes internos do PlaidCloud, por isso fica na área PlaidAdmin e não é mostrado aqui.

Nota

Um espaço de trabalho pode parecer saudável nas ferramentas de implantação e ainda assim não estar utilizável, porque a conclusão da implantação não é o mesmo que o espaço de trabalho concluir sua própria configuração. A coluna Provisioning informa a configuração do próprio espaço de trabalho, que é a que decide se você consegue entrar.

Logon único

Permita que as pessoas entrem em um espaço de trabalho com o provedor de identidade da sua empresa, em vez de uma senha separada do PlaidCloud. Na página Workspaces, escolha Single sign-on no espaço de trabalho. A caixa de diálogo lista as Sign-in options atuais, cada uma com seu estado (Ativado ou Desativado), Test sign-in e Remover, e adiciona novas em Add an identity provider.

Planos e métodos de login

Todos os planos, inclusive o Free (Sandbox), incluem login com senha e autenticação multifator (MFA) e login social com Google, Microsoft (login “common”, pessoal ou organizacional) e GitHub. Os planos mais altos adicionam o logon único corporativo com seu próprio provedor de identidade:

Plano	Adiciona
Free (Sandbox)	Nada além dos métodos de login que todos os planos incluem
Starter	Nada além dos métodos de login que todos os planos incluem
Team	SAML
Business	Microsoft Entra ID e Okta
Enterprise	Outros provedores OpenID Connect e SCIM

Cada plano inclui tudo o que está nos planos abaixo dele. No Free (Sandbox) e no Starter, a caixa de diálogo Single sign-on mostra um aviso de upgrade em vez das opções de provedor de identidade.

Se você fizer downgrade, os provedores que você já adicionou continuam listados e você ainda pode removê-los, mas não pode adicionar novos que o plano não inclua.

Adição de um provedor de identidade

1. Escolha o Identity provider: Microsoft Entra ID, Okta ou Other (OpenID Connect), conforme o seu plano permitir.
2. Copie o Redirect URI com Copiar e registre-o no seu provedor de identidade, conforme descrito abaixo.
3. Preencha os campos do seu provedor e escolha Add provider.
4. Escolha Test sign-in, que abre seu espaço de trabalho para que você entre por meio do novo provedor em uma janela privada. Teste antes de avisar sua equipe.

Provedor	Registre no seu provedor de identidade	Insira no PlaidCloud
Microsoft Entra ID	No centro de administração do Microsoft Entra, registre um aplicativo (plataforma Web) com o URI de redirecionamento, adicione um segredo do cliente em Certificates & secrets e adicione a declaração opcional email ao token de ID em Token configuration.	Directory (tenant) ID, ID do cliente, Segredo do cliente
Okta	No Okta Admin Console, crie um aplicativo Web OIDC com o URI de redirecionamento como URI de redirecionamento de login e atribua as pessoas que devem ter acesso.	Okta domain (por exemplo, acme.okta.com), ID do cliente, Segredo do cliente
Other (OpenID Connect)	Registre um cliente web confidencial com o URI de redirecionamento.	Button label, Discovery URL, ID do cliente, Segredo do cliente

Para Other (OpenID Connect), o PlaidCloud lê os endpoints a partir da URL de descoberta. Se ele não conseguir ler uma configuração de lá, ou se o emissor estiver em um site diferente da URL de descoberta, selecione Enter endpoints manually e preencha Issuer, Authorization URL, Token URL, JWKS URL e, opcionalmente, Userinfo URL (optional). Os endereços do provedor devem ser hosts públicos que o PlaidCloud consiga acessar.

O Button label é o nome que as pessoas veem na página de login, por exemplo, Acme SSO.

Contas existentes e verificação de e-mail

• Quem já tem uma conta do PlaidCloud com o mesmo e-mail a vincula entrando nessa conta uma vez. O PlaidCloud nunca vincula contas apenas porque o e-mail coincide.
• Trust email addresses from this provider (new people skip email verification) vem desativado por padrão. Novas pessoas verificam o endereço de e-mail na primeira vez que entram. Ative-o somente quando o seu provedor de identidade garantir os endereços que envia.

Remoção de um provedor de identidade

Escolha Remover ao lado do provedor. As pessoas não poderão mais entrar com ele. As contas que elas já têm permanecem, e elas podem redefinir a senha para entrar.

Ações em lote

Selecione um ou mais espaços de trabalho para usar as ações em lote.

Ação em lote	Descrição
Definir versão	Fixa os espaços de trabalho selecionados em uma versão escolhida. Todos os espaços de trabalho selecionados devem usar o mesmo canal de liberação.
Pausar	Pausa os espaços de trabalho selecionados.
Retomar	Restaura os espaços de trabalho pausados selecionados.

Configurações principais

As configurações principais identificam o espaço de trabalho, atribuem a propriedade e controlam o comportamento de liberação.

Configuração	Descrição
Nome	Nome de exibição do espaço de trabalho.
ID	Identificador exclusivo do espaço de trabalho. Ele passa a fazer parte da identidade do espaço de trabalho e é definido durante a criação.
Memorando	Descrição opcional ou observação administrativa.
Organização	Organização proprietária do espaço de trabalho.
Proprietário	E-mail do proprietário do espaço de trabalho.
Data center (cluster)	Data center ou cluster onde o espaço de trabalho é executado.
Liberar	Canal de liberação: Rapid, Regular, Stable ou No Release (fixado).
Versão	Versão específica implantada.
Ativo	Marca o espaço de trabalho como ativo.
Pausado	Pausa a operação do espaço de trabalho sem excluí-lo.
Duração do link de convite	Por quanto tempo os links de convite de novos usuários permanecem válidos. As opções são 12 horas, 1 dia, 2 dias, 3 dias, 5 dias, 7 dias, 10 dias e 14 dias.

Opções de liberação

Liberação	Uso típico
Rapid	Recebe as atualizações primeiro. Use em espaços de trabalho que aceitam mudanças de produto mais rápidas.
Regular	Cadência de atualização padrão para a maioria dos espaços de trabalho.
Stable	Cadência mais lenta para espaços de trabalho que priorizam a estabilidade das atualizações.
No Release (fixado)	Mantém o espaço de trabalho na versão selecionada até que um administrador a altere.

A janela de manutenção determina quando as atualizações de liberação automáticas são aplicadas.

Atualizações de liberação automáticas

O PlaidCloud publica novas liberações continuamente e as entrega aos seus espaços de trabalho de forma automática. Você não solicita nem instala uma atualização: quando uma liberação chega ao canal de liberação de um espaço de trabalho, o PlaidCloud atualiza o espaço de trabalho durante sua janela de manutenção. O canal de liberação decide a rapidez com que uma liberação chega; a janela de manutenção decide em que horário do dia a atualização acontece.

Como uma liberação chega a um espaço de trabalho

1. O PlaidCloud publica uma liberação em um canal. O Rapid a recebe primeiro, depois o Regular e, por fim, o Stable.
2. Todas as pessoas da organização recebem um e-mail de aviso prévio pelo menos sete dias antes da atualização, informando a liberação e a data em que ela será aplicada.
3. Na primeira janela de manutenção do espaço de trabalho após esse aviso, o PlaidCloud atualiza o espaço de trabalho para a liberação. A janela de manutenção padrão é domingo, às 02:00 UTC; defina o dia e o horário em Manutenção.
4. A Versão do espaço de trabalho é atualizada para a nova liberação. Nenhuma ação é necessária de você nem dos usuários do espaço de trabalho.

Como um espaço de trabalho só é atualizado dentro de sua própria janela de manutenção, as atualizações ocorrem em um horário previsível e de pouco tráfego, e o aviso de sete dias dá a cada organização tempo para se planejar para a mudança.

Como optar por não receber: fixar um espaço de trabalho

Para manter um espaço de trabalho na versão atual, defina o canal de Liberar como No Release (fixado). As atualizações automáticas ignoram um espaço de trabalho fixado, que permanece na versão selecionada até que um administrador escolha uma nova versão ou o coloque de volta em um canal. Fixe um espaço de trabalho quando ele precisar permanecer inalterado, por exemplo, durante um ciclo de validação ou um fechamento regulamentado.

Fixar interrompe apenas as atualizações futuras; não reverte uma atualização que já foi aplicada. Para avançar novamente um espaço de trabalho fixado, escolha uma Versão específica ou selecione o canal Rapid, Regular ou Stable, e o espaço de trabalho volta ao agendamento automático.

Temas

As configurações de temas personalizam a identidade visual nos pontos de entrada do espaço de trabalho.

Configuração	Descrição
Logotipo do aplicativo	Logotipo exibido no aplicativo do espaço de trabalho.
Logotipo da tela inicial	Logotipo exibido na tela inicial ou de login do espaço de trabalho.
Logotipo do Superset	Logotipo exibido no serviço de painéis.
Temas personalizados do Superset	Temas de cores personalizados de painéis disponíveis para o espaço de trabalho.

Serviços

As configurações de serviço ativam aplicativos opcionais e serviços de apoio dentro do espaço de trabalho.

Configuração	Descrição
JupyterHub	Ativa o acesso a notebooks hospedados para os usuários do espaço de trabalho.
Console SQL web (CloudBeaver)	Ativa o acesso SQL baseado em navegador.
Painéis (Apache Superset)	Ativa o serviço de painéis.
Formulários e fluxos de trabalho de usuário (Forms Flow)	Ativa o suporte a formulários e a aplicativos de fluxo de trabalho.
Captura de dados alterados (Apache Flink)	Ativa o processamento de captura de dados alterados.
Acesso SFTP e interface web	Ativa o acesso SFTP e a interface web do SFTP.
Usar download por proxy do PlaidCloud	Encaminha os downloads pelo caminho de proxy do PlaidCloud.
Ativar banco de dados vetorial (Weaviate)	Ativa o suporte a banco de dados vetorial.
Ativar sandbox de aplicativos personalizados	Ativa o suporte a sandbox de aplicativos personalizados.
Ativar aplicativo de gerenciamento de projetos	Ativa o aplicativo de gerenciamento de projetos.

Alguns serviços podem exigir provisionamento adicional fora do formulário do plano de controle antes que os usuários possam usá-los.

Lakehouse

As configurações do Lakehouse controlam a conectividade externa com o banco de dados e usuários de banco de dados adicionais.

Configuração	Descrição
Ativar acesso externo ao banco de dados	Permite que clientes externos se conectem ao Lakehouse do espaço de trabalho.
CIDRs permitidos	Intervalos CIDR separados por vírgula que têm permissão para se conectar. Deixe em branco se nenhuma lista de permissão for necessária.
CIDRs negados	Intervalos CIDR separados por vírgula que são negados.
Usuários adicionais do Lakehouse	Nomes de usuário e senhas adicionais do Lakehouse para acesso ao banco de dados.

Use os intervalos CIDR mais restritos que atendam a seus usuários e integrações. Remova os usuários do Lakehouse não utilizados quando o acesso não for mais necessário.

Manutenção

As configurações de manutenção definem a janela de atualização preferida do espaço de trabalho.

Configuração	Descrição
Dia	Dia da semana da manutenção: de domingo a sábado.
Horário	Horário do dia em incrementos de 15 minutos.

As atualizações do canal de liberação usam a janela de manutenção do espaço de trabalho. Os espaços de trabalho fixados são ignorados pelas atualizações automáticas do canal de liberação até que um administrador selecione uma nova versão ou um novo canal.