Pular para o conteúdo

Lendo dados e o usuário conectado

Um aplicativo Panel de servidor pode ler os seus dados do PlaidCloud — e faz isso como a pessoa que o está visualizando. Quando alguém abre o aplicativo, o PlaidCloud o conecta com o mesmo logon único que o restante da plataforma usa, e cada chamada feita pelo seu aplicativo é executada com as permissões do próprio visualizador. Não existe conta de serviço compartilhada, e o aplicativo nunca pode ver dados que o visualizador não poderia ver por conta própria.

Isso se aplica somente a aplicativos do tipo Servidor. Aplicativos WASM são executados inteiramente no navegador e não têm conexão do lado do servidor.

Use PlaidConnection, informando o projeto cujos dados você quer ler:

from plaidcloud.utilities.connect import PlaidConnection
conn = PlaidConnection(project_id="<your-project-id>")

Essa é toda a configuração necessária. Você não informa token, nome de usuário nem senha — a conexão se autentica automaticamente como o visualizador conectado. Encontre o ID do seu projeto na URL do projeto ou na página de configurações dele.

Informe um projeto. Um aplicativo publicado com um projeto no seletor Projeto lê esse projeto por padrão, e a Data API o usa para table("name"). Para um aplicativo sem projeto, passe project_id para PlaidConnection como acima; um PlaidConnection() sem argumentos não tem projeto para ler.

Com uma conexão, carregue uma tabela em um DataFrame do pandas pelo nome:

df = conn.get_dataframe("Sales Ledger")

Como a conexão é o visualizador, isso retorna somente as linhas que ele tem permissão para ver e gera um erro de permissão se ele não tiver nenhum acesso ao projeto.

Leia tabelas pelo nome, sem escrever SQL. Em um projeto no qual um administrador ativou o Acesso a linhas, a leitura pelo nome retorna as linhas de cada visualizador, e uma consulta composta pelo próprio aplicativo também retorna, em um warehouse StarRocks, Databend, Greenplum ou Postgres. Uma consulta em um warehouse Snowflake ou Databricks, ou que não seja um único SELECT sobre as tabelas do projeto (uma gravação ou várias instruções), é recusada para qualquer pessoa que não seja Arquiteto do projeto. Ler pelo nome mantém seu aplicativo funcionando nos dois casos.

Para adaptar o que o aplicativo mostra a quem está olhando — uma saudação personalizada, ocultar uma guia ou segurança em nível de linha — leia o usuário conectado pelo Panel:

import panel as pn
viewer = pn.state.user # the viewer's email address
token = pn.state.access_token # their JWT, if you need claims or group membership

pn.state.user é o e-mail do visualizador, obtido do logon verificado dele — você pode confiar nele como identidade. pn.state.access_token é o token de acesso bruto, útil se você precisar decodificar declarações de grupo ou função para regras mais refinadas.

Combine os dois: leia o visualizador e filtre cada consulta por ele. Por exemplo, para mostrar a cada gerente regional apenas a própria região:

import panel as pn
from plaidcloud.utilities.connect import PlaidConnection
pn.extension()
viewer = pn.state.user
conn = PlaidConnection(project_id="<your-project-id>")
sales = conn.get_dataframe("Regional Sales")
mine = sales[sales["manager_email"] == viewer]
pn.Column(
f"# Sales for {viewer}",
pn.pane.DataFrame(mine, index=False),
).servable()

Como a conexão já aplica as permissões de projeto do visualizador, essa filtragem é uma moldagem adicional sobre o que ele tem permissão para ver — não um substituto para o controle de acesso do próprio PlaidCloud.

Faça as chamadas de dados a partir do fluxo principal do aplicativo. O visualizador conectado está disponível enquanto o código do seu aplicativo é executado para a sessão dele (que é onde o trabalho de .servable() acontece). Se você enviar uma chamada bloqueante para uma thread em segundo plano, use asyncio.to_thread — um pool de threads simples não carrega a identidade da sessão, e a conexão falhará de forma explícita em vez de ler os dados errados.

Se você publicou com Permitir acesso público, o aplicativo é servido sem logon, então não há visualizador para representar — pn.state.user fica vazio e um PlaidConnection() não tem ninguém para autenticar. Limite os aplicativos públicos a dados que sejam seguros para qualquer pessoa, ou deixe o acesso público desativado para que os visualizadores façam logon e o modelo por usuário descrito acima se aplique.