Ingerir dados do Anthropic
Beta
Esse recurso está em Beta. Administradores do Workspace podem controlar o acesso a este recurso na página **Pré-visualizações**. Consulte Gerenciar prévias do Databricks.
Esta página mostra como criar um pipeline de ingestão gerenciado da Anthropic usando o Lakeflow Connect.
Requisitos
-
Para criar um pipeline de ingestão, você deve primeiro atender aos seguintes requisitos:
-
Seu workspace deve estar habilitado para o Unity Catalog.
-
O compute serverless deve ser habilitado para o seu workspace. Consulte requisitos de Computação serverless.
-
Para criar uma nova conexão, você deve ter privilégios
CREATE CONNECTIONno metastore. Consulte Gerenciar privilégios no Unity Catalog.Se o conector suportar a criação de pipeline baseada em IU, um administrador poderá criar a conexão e o pipeline ao mesmo tempo, concluindo os passos desta página. No entanto, se os usuários que criam pipelines usarem a criação de pipelines baseada em API ou forem usuários não administradores, um administrador deve primeiro criar a conexão no Catalog Explorer. Consulte Conectar-se a fontes de ingestão gerenciadas.
-
Para usar uma conexão existente, você deve ter os privilégios
USE CONNECTIONouALL PRIVILEGESno objeto de conexão. -
Você deve ter privilégios
USE CATALOGno catálogo de destino. -
É necessário ter privilégios
USE SCHEMAeCREATE TABLEem um esquema existente ou privilégiosCREATE SCHEMAno catálogo de destino.
-
-
Para ingerir do Anthropic, você deve primeiro configurar a autenticação do Databricks. Consulte Configurar a autenticação para o Anthropic.
Criar um pipeline de ingestão
- Databricks UI
- Declarative Automation Bundles
- Databricks notebook
- Na barra lateral do Databricks Workspace, clique em Ingestão de Dados .
- Na página Adicionar dados , em Conectores do Databricks , clique em Anthropic .
- Na página Conexão do assistente de ingestão, selecione a conexão que armazena suas credenciais de acesso do Anthropic. Se você tiver o privilégio
CREATE CONNECTIONno metastore, poderá clicar emCriar conexão para criar uma nova conexão com os detalhes de autenticação em Criar uma conexão do Anthropic.
- Clique em Avançar .
- Na página Configuração da ingestão , insira um nome exclusivo para o pipeline.
- Selecione um catálogo e um esquema para gravar Logs de eventos. Se você tiver os privilégios
USE CATALOGeCREATE SCHEMAno catálogo, você pode clicar emCriar esquema no menu suspenso para criar um novo esquema.
- Clique em **Criar pipeline e continuar**.
- Na página **Source**, selecione as tabelas para ingestão.
- Clique em Salvar e continuar .
- Na página Destino , selecione um catálogo e um esquema para carregar os dados. Se você tiver privilégios
USE CATALOGeCREATE SCHEMAno catálogo, você pode clicar emCriar esquema no menu suspenso para criar um novo esquema.
- Clique em Salvar e continuar .
- (Opcional) Na página Agendamentos e notificações , clique em
Criar agendamento . Defina a frequência para refresh as tabelas de destino.
- (Opcional) Clique em
Adicionar notificação para definir notificações por email para sucesso ou falha da operação do pipeline e, em seguida, clique em Salvar e executar pipeline .
Use os Pacotes de Automação Declarativa para gerenciar pipelines Anthropic como código. Os pacotes podem conter definições YAML de Jobs e tarefas, são gerenciados usando a CLI do Databricks e podem ser compartilhados e executados em diferentes Workspaces de destino (como desenvolvimento, preparo e produção). Para obter mais informações, consulte O que são Pacotes de Automação Declarativa?.
-
Crie um pacote usando a CLI do Databricks:
Bashdatabricks bundle init -
Adicione dois novos arquivos de recurso ao pacote:
- Um arquivo de definição de pipeline (por exemplo,
resources/anthropic_pipeline.yml). Consulte pipeline.ingestion_definition e Exemplos. - Um arquivo de definição de Job que controla a frequência da ingestão de dados (por exemplo,
resources/anthropic_job.yml).
- Um arquivo de definição de pipeline (por exemplo,
-
Implante o pipeline usando a CLI do Databricks:
Bashdatabricks bundle deploy
- Importe o seguinte Notebook para seu Workspace Databricks:
-
Deixe as células um e dois como estão. Não modifique.
-
Modifique a célula três com os detalhes de configuração do seu pipeline. Consulte pipeline.ingestion_definition e Exemplos.
-
Opcionalmente, configure as configurações avançadas do pipeline. Consulte Padrões Comuns para Pipelines de Ingestão Gerenciada.
-
Clique em Executar tudo .
Exemplos
Use estes exemplos para configurar seu pipeline.
Ingerir o esquema inteiro
- Declarative Automation Bundles
- Databricks notebook
O arquivo de definição de pipeline a seguir ingere todas as tabelas do Anthropic compatíveis em um esquema de destino:
resources:
pipelines:
anthropic_pipeline:
name: anthropic_pipeline
catalog: 'main'
target: 'anthropic_data'
ingestion_definition:
connection_name: anthropic_connection
objects:
- schema:
source_schema: 'default'
destination_catalog: 'main'
destination_schema: 'anthropic_data'
A seguinte especificação de pipeline ingere todas as tabelas Anthropic suportadas em um esquema de destino:
pipeline_name = "anthropic_pipeline"
connection_name = "<anthropic-connection>"
pipeline_spec = {
"name": pipeline_name,
"ingestion_definition": {
"connection_name": connection_name,
"objects": [
{
"schema": {
"source_schema": "default",
"destination_catalog": "main",
"destination_schema": "anthropic_data"
}
}
]
}
}
json_payload = json.dumps(pipeline_spec, indent=2)
create_pipeline(json_payload)
Ingerir tabelas específicas
Ingerir tabelas individuais do Anthropic. Para obter uma lista completa de tabelas compatíveis, consulte Tabelas de origem compatíveis.
- Declarative Automation Bundles
- Databricks notebook
O seguinte arquivo de definição de pipeline ingere tabelas individuais do Anthropic:
resources:
pipelines:
anthropic_pipeline:
name: anthropic_pipeline
catalog: 'main'
target: 'anthropic_data'
ingestion_definition:
connection_name: anthropic_connection
objects:
- table:
source_schema: 'default'
source_table: 'audit_log_activities'
destination_catalog: 'main'
destination_schema: 'anthropic_data'
destination_table: 'audit_log_activities'
- table:
source_schema: 'default'
source_table: 'organizations'
destination_catalog: 'main'
destination_schema: 'anthropic_data'
destination_table: 'organizations'
- table:
source_schema: 'default'
source_table: 'users'
destination_catalog: 'main'
destination_schema: 'anthropic_data'
destination_table: 'users'
- table:
source_schema: 'default'
source_table: 'chats'
destination_catalog: 'main'
destination_schema: 'anthropic_data'
destination_table: 'chats'
A seguinte especificação de pipeline ingere tabelas individuais da Anthropic:
pipeline_name = "anthropic_pipeline"
connection_name = "<anthropic-connection>"
pipeline_spec = {
"name": pipeline_name,
"ingestion_definition": {
"connection_name": connection_name,
"objects": [
{
"table": {
"source_schema": "default",
"source_table": "audit_log_activities",
"destination_catalog": "main",
"destination_schema": "anthropic_data",
"destination_table": "audit_log_activities"
}
},
{
"table": {
"source_schema": "default",
"source_table": "organizations",
"destination_catalog": "main",
"destination_schema": "anthropic_data",
"destination_table": "organizations"
}
},
{
"table": {
"source_schema": "default",
"source_table": "users",
"destination_catalog": "main",
"destination_schema": "anthropic_data",
"destination_table": "users"
}
},
{
"table": {
"source_schema": "default",
"source_table": "chats",
"destination_catalog": "main",
"destination_schema": "anthropic_data",
"destination_table": "chats"
}
}
]
}
}
json_payload = json.dumps(pipeline_spec, indent=2)
create_pipeline(json_payload)
Arquivo de definição de job de Pacotes de Automação Declarativa
- Declarative Automation Bundles
resources:
jobs:
anthropic_job:
name: anthropic_job
schedule:
quartz_cron_expression: '0 0 0 * * ?'
timezone_id: 'UTC'
tasks:
- task_key: anthropic_ingestion
pipeline_task:
pipeline_id: ${resources.pipelines.anthropic_pipeline.id}
Padrões comuns
Para configurações avançadas de pipeline, consulte Padrões comuns para pipelines de ingestão gerenciados.
Próximos passos
Comece, programe e defina alertas em seu pipeline. Consulte Tarefas comuns de manutenção de pipeline.