- Categorias:
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 |
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" |
| | | | | | | | } |
+-------------------------------+----------------------------------------------------------------------------------+---------------------+-----------------+-------------------+--------------------------------------+---------------------+---------------------------------+