Categorias:

Information Schema , Funções de tabela

DATA_TRANSFER_HISTORY

Esta função de tabela pode ser usada para consultar o histórico dos dados transferidos das tabelas Snowflake para a rede de um provedor de armazenamento em nuvem diferente (ou seja, do Snowflake em AWS, Google Cloud Platform ou Microsoft Azure para a rede do outro provedor de nuvem) e/ou região geográfica dentro de um intervalo de datas especificado. A função retorna o histórico de toda a sua conta Snowflake.

Nota

Esta função retorna a atividade de transferência de dados dos últimos 14 dias.

Sintaxe

DATA_TRANSFER_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ] )
Copy

Argumentos

Todos os argumentos são opcionais.

DATE_RANGE_START => constant_expr , . DATE_RANGE_END => constant_expr

O intervalo de data/hora, das últimas 2 semanas, para o qual se pode recuperar o histórico de transferência 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 da transferência de dados). Por exemplo, se DATE_RANGE_END for CURRENT_DATE, então o padrão DATE_RANGE_START é 11:50 PM no dia anterior.

O histórico é exibido em incrementos de 5 minutos, 1 hora ou 24 horas (dependendo da extensão da faixa especificada).

Se o intervalo estiver fora dos últimos 15 dias, um erro é retornado.

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.

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

START_TIME

TIMESTAMP_LTZ

Início do intervalo de tempo especificado em que a transferência de dados ocorreu.

END_TIME

TIMESTAMP_LTZ

Fim do intervalo de tempo especificado em que a transferência de dados ocorreu.

SOURCE_CLOUD

TEXT

Nome do provedor da nuvem onde se originou a transferência de dados: Amazon Web Services, Google Cloud Platform ou Microsoft Azure.

SOURCE_REGION

TEXT

Região de origem da transferência de dados.

TARGET_CLOUD

TEXT

Nome do provedor de nuvem para onde os dados foram enviados: AWS, Google Cloud Platform ou Microsoft Azure.

TARGET_REGION

TEXT

Região para onde os dados foram enviados.

BYTES_TRANSFERRED

NUMBER

Número de bytes transferidos durante o intervalo START_TIME e END_TIME.

TRANSFER_TYPE

VARCHAR

Tipo de operação que causou a transferência. COPY, EXTERNAL_ACCESS, EXTERNAL_FUNCTION, REPLICATION.

Exemplos

Recuperar o histórico de transferência de dados por um intervalo de 30 minutos, em períodos de 5 minutos, para sua conta:

select *
  from table(mydb.information_schema.data_transfer_history(
    date_range_start=>to_timestamp_tz('2017-10-24 12:00:00.000 -0700'),
    date_range_end=>to_timestamp_tz('2017-10-24 12:30:00.000 -0700')));
Copy

Recuperar o histórico de transferência de dados das últimas 12 horas, em períodos de 1 hora, para sua conta:

select *
  from table(information_schema.data_transfer_history(
    date_range_start=>dateadd('hour',-12,current_timestamp())));
Copy

Recuperar o histórico de transferência de dados dos últimos 14 dias, em períodos de 1 dia, para sua conta:

select *
  from table(information_schema.data_transfer_history(
    date_range_start=>dateadd('day',-14,current_date()),
    date_range_end=>current_date()));
Copy
Linguagem: Português