Categorias:

Information Schema , Funções de tabela

DATABASE_REPLICATION_USAGE_HISTORY

Esta função de tabela pode ser usada para consultar o histórico de replicação para um banco de dados especificado dentro de um intervalo de datas determinado. As informações retornadas pela função incluem o nome do banco de dados, créditos consumidos e bytes transferidos para replicação.

Nota

Esta função retorna a atividade de uso de replicação de banco de dados dos últimos 14 dias.

Sintaxe

DATABASE_REPLICATION_USAGE_HISTORY(
  [ DATE_RANGE_START => <constant_expr> ]
  [ , DATE_RANGE_END => <constant_expr> ]
  [ , DATABASE_NAME => '<string>' ] )
Copy

Argumentos

Todos os argumentos são opcionais.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

O intervalo de data/hora para exibir o histórico de replicação do banco de dados:

  • Se uma data final não for especificada, então CURRENT_DATE é usada como o fim do intervalo.

  • Se uma data de início não for especificada, então o intervalo começa 10 minutos antes do início de DATE_RANGE_END (ou seja, o padrão é mostrar os 10 minutos anteriores do histórico).

Por exemplo, se DATE_RANGE_END for CURRENT_DATE, então o padrão DATE_RANGE_START é 11:50 PM no dia anterior.

DATABASE_NAME => 'string'

Nome do banco de dados. Se especificado, mostra apenas o histórico para o banco de dados especificado.

Se um nome não for especificado, então os resultados incluem os dados para cada banco de dados replicado no intervalo de tempo especificado.

Saída

A função retorna os seguintes elementos em um objeto JSON:

Nome da coluna

Tipo de dados

Descrição

START_TIME

TIMESTAMP_LTZ

Início do intervalo especificado.

END_TIME

TIMESTAMP_LTZ

Fim do intervalo especificado.

DATABASE_NAME

TEXT

Nome do banco de dados.

CREDITS_USED

TEXT

Número de créditos faturados para replicação de banco de dados durante o intervalo START_TIME e END_TIME.

BYTES_TRANSFERRED

NUMBER

Número de bytes transferidos para replicação de banco de dados durante o intervalo START_TIME e END_TIME.

Notas de uso

  • Retorna resultados apenas para a função ACCOUNTADMIN ou qualquer função que tenha sido explicitamente concedido o privilégio global MONITOR USAGE.

  • 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.

Exemplos

Recuperar o histórico de replicação por um intervalo de 30 minutos para sua conta:

select database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>'2023-03-28 12:00:00.000 +0000',
    date_range_end=>'2023-03-28 12:30:00.000 +0000'));
Copy

Recuperar o histórico das últimas 12 horas para sua conta:

select database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>dateadd(H, -12, current_timestamp)));
Copy

Recuperar o histórico da última semana para sua conta:

select start_time, end_time, database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>dateadd(d, -7, current_date),
    date_range_end=>current_date));
Copy

Recuperar o histórico de replicação da última semana para um banco de dados mydb em sua conta:

select start_time, end_time, database_name, credits_used, bytes_transferred
  from table(information_schema.database_replication_usage_history(
    date_range_start=>dateadd(d, -7, current_date),
    date_range_end=>current_date,
    database_name=>'mydb'));
Copy
Linguagem: Português