- Categorias:
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> ] )
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
a10000
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, |
ENDPOINT |
TEXT |
O ponto de extremidade na solicitação de API (por exemplo, |
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;