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