Categorias:

Funções de tabela

REST_EVENT_HISTORY

Retorna uma lista de solicitações SCIM REST API feitas ao Snowflake durante um intervalo de tempo especificado.

Sintaxe

REST_EVENT_HISTORY(
      REST_SERVICE_TYPE => 'scim'
      [, TIME_RANGE_START => <constant_expr> ]
      [, TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <integer> ] )
Copy

Argumentos

Obrigatório:

REST_SERVICE_TYPE => 'scim'

O tipo de serviço REST API. Atualmente, o Snowflake oferece suporte apenas a SCIM.

Opcional:

TIME_RANGE_START => <constant_expr>, . TIME_RANGE_END => <constant_expr>

Intervalo de hora (no formato TIMESTAMP_LTZ), dos últimos 7 dias, no qual o evento de login ocorreu.

  • Se TIME_RANGE_START não for especificado, todos os logs dos últimos sete dias são retornados.

  • Se TIME_RANGE_END não for especificado, todos os logs são retornados.

Se o intervalo não ficar dentro dos últimos 7 dias, um erro é retornado.

Para obter mais informações sobre as funções que você pode utilizar, consulte Funções de data e hora.

RESULT_LIMIT => <integer>

Um número especificando o número máximo de linhas retornadas pela função.

Se o número de linhas correspondentes for maior que este limite, as consultas com o tempo final mais recente (ou aquelas que ainda estão em execução) são retornadas até o limite especificado.

Intervalo: 1 a 10000

Padrão: 100.

Notas de uso

  • Atualmente, a função de tabela REST_EVENT_HISTORY só pode ser usada com SCIM.

  • Somente administradores de conta (ou seja, usuários com a função ACCOUNTADMIN) podem obter resultados de consulta.

Saída

A função retorna as seguintes colunas:

Nome da coluna

Tipo de dados

Descrição

EVENT_TIMESTAMP

TIMESTAMP_LTZ

Hora da ocorrência do evento.

EVENT_ID

NUMBER

O identificador único da solicitação.

EVENT_TYPE

TEXT

A categoria de eventos REST API. Atualmente, SCIM é o único valor possível.

ENDPOINT

TEXT

O ponto de extremidade na solicitação de API (por exemplo, scim/v2/Users/<id>).

METHOD

TEXT

O método HTTP utilizado na solicitação.

STATUS

TEXT

O resultado do status HTTP da solicitação.

ERROR_CODE

TEXT

Código de erro, caso a solicitação não tenha sido bem sucedida.

DETAILS

TEXT

Uma descrição do resultado da solicitação API no formato JSON.

CLIENT_IP

TEXT

O endereço IP de onde se originou a solicitação.

ACTOR_NAME

TEXT

O nome de quem criou a solicitação.

ACTOR_DOMAIN

TEXT

O domínio (isto é, integração de segurança) no qual a solicitação foi feita.

RESOURCE_NAME

TEXT

O nome do objeto que faz a solicitação.

RESOURCE_DOMAIN

TEXT

O tipo de objeto (por exemplo, usuário) que faz a solicitação.

Exemplos

Retornar as solicitações SCIM REST API feitas nos últimos cinco minutos, até 200 solicitações.

use role accountadmin;
use database my_db;
use schema information_schema;
select *
  from table(rest_event_history(
      rest_service_type => 'scim',
      time_range_start => dateadd('minutes',-5,current_timestamp()),
      time_range_end => current_timestamp(),
      200))
  order by event_timestamp;
Copy