STORAGE_LIFECYCLE_POLICY_HISTORY¶

Sintaxe¶

Por objeto

STORAGE_LIFECYCLE_POLICY_HISTORY(
  REF_ENTITY_NAME => '<string>',
  REF_ENTITY_DOMAIN => '<string>'
  [, TIME_RANGE_START => <constant_expr> ]
  [, TIME_RANGE_END => <constant_expr> ]
  [, RESULT_LIMIT => <integer> ] )

Por política de ciclo de vida de armazenamento

STORAGE_LIFECYCLE_POLICY_HISTORY(
  POLICY_NAME => '<string>'
  [, TIME_RANGE_START => <constant_expr> ]
  [, TIME_RANGE_END => <constant_expr> ]
  [, RESULT_LIMIT => <integer> ] )

Argumentos¶

Obrigatório:

REF_ENTITY_NAME => 'string'

O identificador do objeto (tabela) em que a execução ocorreu; por exemplo, o nome da tabela à qual a política de ciclo de vida de armazenamento está anexada.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas. Para obter mais informações, consulte Requisitos para identificadores.

REF_ENTITY_DOMAIN => 'string'

O tipo de objeto ao qual a política de ciclo de vida de armazenamento está anexada:

• 'Table': especifica que a política de ciclo de vida de armazenamento está anexada a uma tabela.

POLICY_NAME => 'string'

O identificador de uma política de ciclo de vida de armazenamento da qual recuperar o histórico de execução. Se você não especificar o nome da política, deverá especificar valores para REF_ENTITY_NAME e REF_ENTITY_DOMAIN.

Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

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

Opcional:

TIME_RANGE_START => constant_expr, . TIME_RANGE_END => constant_expr

Intervalo de tempo, nos últimos 14 dias, em que ocorreu a execução da política.

Se nenhum parâmetro for especificado, a função retornará linhas (até o RESULT_LIMIT) para as últimas execuções da política em ordem decrescente por END_TIME.

RESULT_LIMIT => integer

O número máximo de linhas retornadas por função.

Intervalo: 1 a 1000

Padrão: 1000.

Retornos¶

A função retorna os registros do histórico de execução para as políticas de ciclo de vida de armazenamento. Cada registro contém informações sobre a execução da política, incluindo o nome da política, a tabela associada, o estado de execução, as horas de início e término e os resultados da execução.

Para obter descrições detalhadas das colunas, consulte Saída.

Saída¶

A função retorna as seguintes colunas:

EXECUTION_RESULT =
{
  “EXPIRE”: {
    “start_time”: "Thu, 27 Jun 2024 02:57:57 -0700",
    “end_time”: "Thu, 27 Jun 2024 02:58:01 -0700",
    “state”: "SUCCEEDED",
    “rows_expired”: 100,
    “error_message_code”: null,
    “error_message”: null
  }
}

Requisitos de controle de acesso¶

Uma função usada para executar esse comando SQL deve ter pelo menos um dos seguintes privilégios, no mínimo:

Notas de uso¶

• Os resultados são retornados com base nos privilégios concedidos à função que executa a consulta:

  • Se a função tiver o privilégio global APPLY STORAGE LIFECYCLE POLICY, o Snowflake retornará todas as execuções da política relacionadas às associações de política e tabela na conta.

  • Se a função tiver o privilégio APPLY em uma política de ciclo de vida de armazenamento específica, o Snowflake retornará as execuções dessa política somente para objetos que são de propriedade da função que chama a função.

  • Se a função tiver ou o privilégio APPLY ou OWNERSHIP na política, mas não tiver o privilégio OWNERSHIP na tabela à qual a política está anexada, o Snowflake não mostrará as execuções da política nos resultados.

  • Se a função não tiver privilégios de política, mas tiver o privilégio OWNERSHIP na tabela à qual uma política está anexada, o Snowflake retornará uma mensagem de erro e não retornará as execuções da política.

Exemplos¶

Especifique os argumentos REF_ENTITY_NAME e REF_ENTITY_DOMAIN para recuperar o histórico da política de ciclo de vida de armazenamento para uma tabela chamada t1:

SELECT * FROM
  TABLE (
    INFORMATION_SCHEMA.STORAGE_LIFECYCLE_POLICY_HISTORY(
      REF_ENTITY_NAME => 'my_db.my_schema.t1',
      REF_ENTITY_DOMAIN => 'Table'
    )
  );

Recupere o histórico da política de ciclo de vida de armazenamento para cada tabela que tenha a política chamada slp associada a ela e limite os resultados a 100 linhas:

SELECT * FROM
  TABLE(
    INFORMATION_SCHEMA.STORAGE_LIFECYCLE_POLICY_HISTORY(
      POLICY_NAME => 'my_db.my_schema.slp',
      RESULT_LIMIT => 100
    )
  );

Recupere as 100 execuções mais recentes de uma política especificada, programadas na última hora:

SELECT * FROM
TABLE(
  INFORMATION_SCHEMA.STORAGE_LIFECYCLE_POLICY_HISTORY(
    POLICY_NAME => 'my_db.my_schema.slp',
    TIME_RANGE_START => DATEADD('HOUR', -1, CURRENT_TIMESTAMP()),
    RESULT_LIMIT => 100
  )
);

Recupere o histórico de execução da política para uma determinada tabela em um intervalo de 30 minutos:

SELECT * FROM
TABLE (
  INFORMATION_SCHEMA.STORAGE_LIFECYCLE_POLICY_HISTORY(
    REF_ENTITY_NAME => 'my_db.my_schema.t1',
    REF_ENTITY_DOMAIN => 'Table',
    TIME_RANGE_START => TO_TIMESTAMP_LTZ('2024-07-08 12:00:00.000 -0700'),
    TIME_RANGE_END => TO_TIMESTAMP_LTZ('2024-07-08 12:30:00.000 -0700')
  )
);