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