Categorias:: Funções de tabela

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY¶

Retorna metadados e informações do instantâneo sobre o histórico de atualização mais recente de uma tabela Apache Iceberg™ gerenciada externamente especificada.

Nota

A versão 9.16 do Snowflake adicionou suporte à tabela baseada em Delta para essa função. A função exibe apenas dados de atualização de tabela baseados em Delta da versão 9.16 e posteriores.

Consulte também:: Tabelas Apache Iceberg™, Metadados e retenção para tabelas Apache Iceberg™, ALTER ICEBERG TABLE … REFRESH

Sintaxe¶

ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
  TABLE_NAME => '<table_name>'
)

Argumentos¶

TABLE_NAME => 'table_name': O nome da tabela Iceberg gerenciada externamente para a qual deseja recuperar o histórico de atualização de instantâneos.

Saída¶

A função retorna as seguintes colunas:


Nome da coluna	Tipo de dados	Descrição	Nota de tabela baseada em Delta
REFRESHED_ON	TIMESTAMP_LTZ	O carimbo de data/hora em que a tabela foi atualizada pela última vez.
METADATA_FILE_NAME	TEXT	O caminho completo para o arquivo de metadados.	O caminho completo para o arquivo de confirmação ou ponto de verificação.
SNAPSHOT_ID	TEXT	O ID de instantâneo da última atualização.	O ID de confirmação resultante da última atualização.
SEQUENCE_NUMBER	TEXT	O número de sequência da última atualização; NULL para Iceberg v1.	Não aplicável para tabelas baseadas em Delta; exibe como NULL.
ICEBERG_SCHEMA_ID	TEXT	O ID de esquema da atualização (a partir de metadados).	Não aplicável para tabelas baseadas em Delta; exibe como NULL.
QUERY_ID	TEXT	O ID de endereço da consulta que realizou a atualização. Para tabelas que usam a atualização automatizada, essa coluna contém um valor sentinela, que indica que a atualização foi automatizada.
IS_CURRENT_SNAPSHOT	BOOLEAN	TRUE se a tabela for atualizada neste instantâneo; caso contrário, FALSE.	TRUE se a tabela estiver atualizada nesta versão (confirmação). Caso contrário, FALSE.
SNAPSHOT_SUMMARY	VARIANT	O resumo do instantâneo Iceberg do arquivo `metadata.json`. NULL se não estiver presente no arquivo de metadados.	Não aplicável para tabelas baseadas em Delta; exibe como NULL.

Exemplos¶

Recupere asa informações da versão atual de uma tabela Iceberg gerenciada externamente chamada my_iceberg_table:

SELECT *
  FROM TABLE(INFORMATION_SCHEMA.ICEBERG_TABLE_SNAPSHOT_REFRESH_HISTORY(
    TABLE_NAME => 'my_iceberg_table'
  ));

Saída:

+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+
| REFRESHED_ON                  | METADATA_FILE_NAME                                                               | SNAPSHOT_ID         | SEQUENCE_NUMBER | ICEBERG_SCHEMA_ID | QUERY_ID                             | IS_CURRENT_SNAPSHOT | SNAPSHOT_SUMMARY                |
|-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------|
| 2024-12-09 11:00:50.506 -0800 | s3://my-bucket/metadata/00000-e3bf7230-283f-4626-a770-fe97a3ca239e.metadata.json | NULL                | NULL            | 0                 | 01b8ebb4-0002-3a10-0000-012903c7e42a | False               | NULL                            |
| 2024-12-09 11:01:35.543 -0800 | s3://my-bucket/metadata/00001-bf116652-b5b0-479a-947e-6c799e4ca124.metadata.json | 6201065399847600377 | NULL            | 0                 | 01b8ebb5-0002-3a14-0000-012903c7f336 | True                | {                               |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "added-records": "150000",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-created": "1",     |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-kept": "0",        |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "manifests-replaced": "0",    |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-data-files": "4",      |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-files-size": "144896", |
|                               |                                                                                  |                     |                 |                   |                                      |                     |   "total-records": "150000"     |
|                               |                                                                                  |                     |                 |                   |                                      |                     | }                               |
+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+