Categorias:

Information Schema , Funções de tabela

TASK_DEPENDENTS

Esta função de tabela retorna a lista de tarefas filho para uma determinada tarefa raiz em um gráfico da tarefa.

Sintaxe

TASK_DEPENDENTS(
      TASK_NAME => '<string>'
      [, RECURSIVE => <Boolean> ] )
Copy

Argumentos

TASK_NAME => 'string'

Uma cadeia de caracteres especificando uma tarefa. A função retorna a tarefa raiz especificada como a primeira entrada, seguida pela lista de tarefas secundárias.

  • Observe que o nome completo deve ser incluído entre aspas simples, incluindo o banco de dados e o esquema (se o nome for totalmente qualificado), ou seja, '<bd>.<esquema>.<nome_tarefa>'.

  • Se o nome da tarefa diferenciar letras maiúsculas e minúsculas ou incluir quaisquer caracteres ou espaços especiais, as aspas duplas são necessárias para processar o caso/caracteres. As aspas duplas devem ser incluídas dentro das aspas simples, ou seja, '"<nome_tarefa>"'.

RECURSIVE => Boolean

Especifica se a saída deve ser limitada para incluir apenas tarefas secundárias diretas ou para incluir todas as tarefas secundárias recursivas.

Valores:

TRUE: retorna todas as tarefas filho recorrentes (filhos, netos etc.) na produção.

FALSE: retorna apenas as tarefas filho diretas na saída.

Padrão: TRUE.

Notas de uso

  • Somente retorna linhas para o proprietário de uma tarefa (isto é, a função com o privilégio OWNERSHIP em uma tarefa) ou uma função com o privilégio MONITOR ou OPERATE em uma tarefa.

  • Ao chamar uma função de tabela do Information Schema, a sessão deve ter um esquema INFORMATION_SCHEMA em uso ou o nome da função deve ser totalmente qualificado. Para obter mais detalhes, consulte Snowflake Information Schema.

Saída

A saída da função fornece propriedades de tabela e metadados nas seguintes colunas:

| created_on | name | database_name | schema_name | owner | comment | warehouse | schedule | predecessors | state | definition | condition |
Copy

Coluna

Descrição

created_on

Data e hora em que a tarefa foi criada.

name

Nome da tarefa.

database_name

Banco de dados para o esquema da tarefa.

schema_name

Esquema para a tarefa.

owner

Função proprietária da tarefa (ou seja, com o privilégio OWNERSHIP na tarefa)

comment

Comentário para a tarefa.

warehouse

Warehouse que fornece os recursos necessários para a execução da tarefa.

schedule

Cronograma para a execução da tarefa. Exibe NULL se nenhum cronograma for especificado.

predecessors

Matriz JSON de quaisquer tarefas identificadas no parâmetro AFTER para a tarefa (isto é, tarefas predecessoras). Quando executadas com sucesso até a conclusão, estas tarefas acionam a tarefa atual. Os nomes das tarefas individuais na matriz são totalmente qualificados (isto é, incluem os nomes do esquema e banco de dados de contêineres). . . Exibe uma matriz vazia se a tarefa não tiver um predecessor.

state

‘Iniciado’ ou ‘Suspenso’ com base no estado atual da tarefa.

definition

Instruções SQL executadas quando a tarefa é executada.

condition

Condição especificada na cláusula WHEN para a tarefa.

Exemplos

Recuperar a lista de tarefas diretas secundárias para a tarefa mydb.myschema.mytask:

select *
  from table(information_schema.task_dependents(task_name => 'mydb.myschema.mytask', recursive => false));
Copy