SYSTEM$GET_TABLE_ARCHIVE_METADATA¶

Sintaxe¶

SYSTEM$GET_TABLE_ARCHIVE_METADATA( '<table_name>' )

Argumentos¶

'table_name'

O nome da tabela com dados arquivados. A tabela deve ter dados arquivados na camada COOL ou COLD, geralmente por uma política de ciclo de vida de armazenamento.

Retornos¶

Retorna um valor TEXT contendo um JSON com metadados sobre os dados arquivados. A estrutura JSON inclui:

• rowCount: o número de linhas no arquivo.

• columns: um objeto contendo os metadados de cada coluna:

  • column_id: o ID da coluna (como mostrado na exibição COLUMNS).

  • data_type: o tipo de dados da coluna.

  • min: o valor mínimo da coluna ou null se não for aplicável.

  • max: o valor máximo da coluna ou null se não for aplicável.

A saída também inclui a coluna de carimbo de data/hora arquivada (METADATA$STORAGE_LIFECYCLE_POLICY_ARCHIVED_TIMESTAMP), que indica quando cada linha foi arquivada.

Exemplo de saída:

{
  "rowCount": 2304,
  "columns": {
    "CUSTOMER_ID": {
      "column_id": 10283,
      "data_type": "fixed",
      "min": -23,
      "max": 54032
    },
    "CUSTOMER_NAME": {
      "column_id": 10284,
      "data_type": "text",
      "min": null,
      "max": null
    },
    "METADATA$STORAGE_LIFECYCLE_POLICY_ARCHIVED_TIMESTAMP": {
      "data_type": "timestampltz",
      "min": "2025-01-02T03:04:05.6789Z",
      "max": "2025-11-12T13:14:15.1617Z"
    }
  }
}

Notas de uso¶

• O proprietário da tabela ou um administrador de conta (um usuário com a função ACCOUNTADMIN) que tem acesso à tabela pode executar esta função.

• Use esta função para inspecionar os metadados de dados arquivados sem incorrer no custo de recuperação de dados da camada de arquivamento.

• O campo column_id ajuda a distinguir colunas quando uma coluna foi descartada e uma nova coluna com o mesmo nome foi adicionada posteriormente.

• Para recuperar os dados reais arquivados, use o comando CREATE TABLE … FROM ARCHIVE OF.

Exemplos¶

Recuperar metadados sobre dados arquivados de uma tabela:

SELECT SYSTEM$GET_TABLE_ARCHIVE_METADATA('my_database.my_schema.my_table');

Analisar a saída de JSON para extrair informações específicas:

SELECT PARSE_JSON(SYSTEM$GET_TABLE_ARCHIVE_METADATA('my_database.my_schema.my_table')):rowCount AS archived_row_count;