Categorias:: Information Schema , Funções de tabela

DBT_PROJECT_EXECUTION_HISTORY¶

Retorna o histórico de execução dos projetos dbt no Snowflake.

Chame essa função para obter os metadados e resultados das execuções anteriores do projeto dbt dentro de sete dias a partir da hora atual. Se preferir, especifique os valores para filtrar os resultados.

Use essa função com as seguintes funções do sistema para acessar logs e artefatos de dbt programaticamente:

Para obter mais informações, consulte Acesso programático a artefatos e logs do dbt.

Consulte também:: CREATE DBT PROJECT, EXECUTE DBT PROJECT

Sintaxe¶

DBT_PROJECT_EXECUTION_HISTORY (
  [ OBJECT_NAME => '<name>' ]
  [ , OBJECT_TYPE = { WORKSPACE | DBT PROJECT }]
  [ , START_TIME_RANGE_START => <start_time> ]
  [ , START_TIME_RANGE_END => <end_time>  ]
  [ , RESULT_LIMIT = <integer> ]
  [ , COMMAND = <dbt_command> ]
  [ , USER_NAME = <user_name> ]
  [ , DATABASE = <db_name> ]
  [ , SCHEMA = <schema_name> ]
)

Copy

Argumentos¶

OBJECT_NAME = <name>

Nome do espaço de trabalho ou projeto dbt ao qual a execução pertence.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais informações, consulte Requisitos para identificadores.

OBJECT_TYPE = { WORKSPACE | DBT PROJECT }

O tipo do objeto, WORKSPACE ou DBT PROJECT, ao qual a execução pertence.

START_TIME_RANGE_START | START_TIME_RANGE_END = timestamp

Carimbo de data/hora para filtrar um intervalo de execuções de projeto dbt.

RESULT_LIMIT = integer

Um número inteiro especificando o número máximo de linhas retornadas pela função, de 1 a 10.000 inclusive.

Padrão: 100

COMMAND = dbt_command

Especifica o comando dbt usado para executar o projeto dbt.

USER_NAME = user_name

Nome do usuário que iniciou a execução do objeto de projeto dbt.

DATABASE = db_name

Retorna somente registros para o banco de dados especificado.

SCHEMA = schema_name

Retorna somente registros para o esquema especificado.

Saída¶

A função retorna as seguintes colunas.

Para exibir essas colunas, é necessário usar uma função com o privilégio MONITOR.

Nome da coluna	Tipo de dados	Descrição
QUERY_ID	TEXT	O ID da consulta.
QUERY_START_TIME	TIMESTAMP_LTZ	A hora em que a consulta começou.
QUERY_END_TIME	TIMESTAMP_LTZ	A hora em que a consulta terminou.
USER_NAME	TEXT	O usuário que criou o projeto dbt.
OBJECT_NAME	TEXT	Nome do espaço de trabalho ou projeto dbt ao qual a execução pertencia.
OBJECT_TYPE	TEXT	Tipo de objeto, como WORKSPACE ou DBT PROJECT.
DATABASE_NAME	TEXT	Banco de dados do objeto.
SCHEMA_NAME	TEXT	Esquema do objeto.
COMMAND	TEXT	O comando que foi executado para o objeto.
ARGS	TEXT	Os argumentos que foram usados na execução do objeto.
ERROR_CODE	NUMBER	Se aplicável, o código de erro da execução.
ERROR_MESSAGE	TEXT	Se aplicável, a mensagem de erro informando o motivo da falha na execução.
WAREHOUSE	TEXT	Warehouse utilizado para o objeto.
STATE	TEXT	Estado da execução, como HANDLED_ERROR ou SUCCESS.

Requisitos de controle de acesso¶

Essa função de tabela inclui apenas execuções de espaços de trabalho e projetos dbt nos quais você tem os seguintes privilégios:

OWNERSHIP ou USAGE nos espaços de trabalho
OWNERSHIP, USAGE ou MONITOR nos projetos dbt

Notas de uso¶

Use o nome exato do projeto dbt (diferencia maiúsculas de minúsculas se criado com aspas). Se nenhuma linha corresponder (nome do projeto dbt errado ou ainda nenhuma execução), você poderá receber o erro Inputs may not be null..

Exemplos¶

Para exemplos de uso da função de tabela DBT_PROJECT_EXECUTION_HISTORY, consulte Acesso programático a artefatos e logs do dbt.