Esquema:: ACCOUNT_USAGE

Exibição AGGREGATE_ACCESS_HISTORY¶

Esta exibição do Account Usage fornece Histórico de acesso agregados para todas as cargas de trabalho no Snowflake. Quando uma carga de trabalho envolve consultas transacionais altamente recorrentes, o padrão de acesso dessas consultas também é repetido com frequência. É mais eficiente visualizar essas informações do histórico de acesso em uma agregação.

A exibição AGGREGATE_ACCESS_HISTORY contém dados semelhantes aos Exibição ACCESS_HISTORY, agregados ao longo do tempo para consultas repetidas em intervalos de um minuto.

Essa exibição também fornece informações de histórico de acesso associadas a consultas analíticas e transacionais. Por outro lado, observe que Exibição ACCESS_HISTORY contém informações de histórico de acesso associadas apenas a consultas que aparecem em Exibição QUERY_HISTORY e não inclui determinadas consultas transacionais de curta duração.

Colunas¶

Nome da coluna	Tipo de dados	Descrição
INTERVAL_START_TIME	TIMESTAMP_LTZ	Hora de início da janela de medição.
INTERVAL_END_TIME	TIMESTAMP_LTZ	Hora de fim da janela de medição.
QUERY_PARAMETERIZED_HASH	TEXT	ID exclusivo para identificar consultas parametrizadas idênticas. Consulte Coluna QUERY_PARAMETERIZED_HASH.
USER_NAME	TEXT	Usuário que emitiu a consulta.
CALLS	NUMBER	O número de vezes que o comportamento de acesso ocorreu durante a janela de tempo especificada por INTERVAL_START_TIME e INTERVAL_END_TIME e acionada por uma consulta parametrizada e um usuário específicos.
DIRECT_OBJECTS_ACCESSED	ARRAY	Uma matriz JSON de objetos de dados, como funções definidas pelo usuário (ou seja UDFs e UDTFs), procedimentos armazenados, tabelas, visualizações e colunas nomeadas diretamente na consulta explicitamente ou por atalhos como o uso de um asterisco (ou seja, `*`). As colunas virtuais podem ser devolvidas neste campo. Para obter notas adicionais sobre UDFs, consulte Notas de uso.
BASE_OBJECTS_ACCESSED	ARRAY	Uma matriz JSON de todos os objetos de dados básicos para executar uma consulta, incluindo colunas, funções externas, UDFs e procedimentos armazenados. No exemplo em Exibição ACCESS_HISTORY, os campos da primeira matriz especificam uma UDF. Estes mesmos campos na primeira matriz também especificam um procedimento armazenado, quando aplicável. Observe o seguinte: Este campo especifica os nomes das exibições ou colunas de exibição, incluindo colunas virtuais, se uma exibição compartilhada for acessada em uma conta de consumidor de compartilhamento de dados. Para obter notas adicionais sobre UDFs, consulte Notas de uso.
OBJECTS_MODIFIED	ARRAY	Uma matriz JSON que especifica os objetos que foram associados a uma operação de gravação na consulta. A matriz de procedimento armazenado e UDF é a mesma que aparece nas matrizes para `baseSources` e `directSources` nos exemplos em Exibição ACCESS_HISTORY, dependendo de como o acesso foi feito. Para maior brevidade, o exemplo omite a matriz de procedimento armazenado e UDF. Para obter notas adicionais sobre UDFs, consulte Notas de uso.
OBJECT_MODIFIED_BY_DDL	OBJECT	Especifica a operação DDL em um banco de dados, esquema, tabela, exibição e coluna. Essas operações também incluem instruções que especificam uma política de acesso a linhas em uma tabela ou exibição, uma política de mascaramento em uma coluna e atualizações de tags (por exemplo, definir uma tag, alterar um valor de tag) no objeto ou coluna.
POLICIES_REFERENCED	ARRAY	Especifica as informações sobre a política de mascaramento aplicada definida na coluna e a política de acesso a linhas aplicada na tabela, incluindo políticas definidas em objetos ou colunas intermediários.

Os campos na matriz JSON para as colunas DIRECT_OBJECTS_ACCESSED, BASE_OBJECTS_ACCESSED, OBJECTS_MODIFIED e POLICIES_REFERENCED estão descritos abaixo.

Campo	Tipo de dados	Descrição
columnId	NUMBER	Uma coluna ID que é única dentro da conta. Este valor é idêntico ao valor na coluna `column_id` na exibição COLUMNS.
columnName	TEXT	O nome da coluna acessada. Para as políticas, especifica a coluna na qual a política de mascaramento é definida.
objetId	NUMBER	Um identificador do objeto, que é único dentro de uma determinada conta e domínio. Este número será correspondente ao seguinte: O valor na coluna `TABLE_ID` nas exibições TABLE, VIEWS e MATERIALIZED_VIEW_REFRESH_HISTORY. Se um estágio foi acessado, este número corresponderá ao seguinte: O identificador `NAME` de um usuário (estágio do usuário). O número `TABLE_ID` de uma tabela (estágio da tabela). Número `STAGE_ID` de um estágio (estágio nomeado).
objectName	TEXT	O nome completo e qualificado do objeto que foi acessado. Se uma política de mascaramento for definida em uma coluna ou uma política de acesso a linhas for definida em uma tabela ou exibição, o valor se referirá ao nome totalmente qualificado da tabela ou exibição na qual a política de acesso a linhas é definida ou a tabela ou exibição que tem uma política de mascaramento definida em uma de suas colunas. Se um estágio foi acessado, este valor será o valor: `username` (estágio do usuário). `table_name` (estágio da tabela). `stage_name` (estágio nomeado).
objectDomain	TEXT	Uma das seguintes opções: `EXTERNAL TABLE`, `FUNCTION`, `MATERIALIZED VIEW`, `PROCEDURE`, `STAGE`, `STREAM` ou `VIEW`. Observe que `FUNCTION` especifica UDFs, UDTFs e funções externas. Para as políticas, especifica o domínio do objeto no qual a política de acesso a linhas é definida.
location	TEXT	O URL do local externo quando os dados são acessados de um local externo (por exemplo, `s3://mybucket/a.csv`). Se a consulta não acessar um estágio, este campo é omitido.
stageKind	TEXT	Ao gravar em um estágio, uma das seguintes opções: `Table`, `User`, `Internal Named` ou `External Named`. Se a consulta não acessar um estágio, este campo é omitido.
baseSources	TEXT	As colunas que servem como colunas de origem para as colunas especificadas por `directSources`. Estas colunas facilitam a linhagem de colunas.
directSources	TEXT	As colunas especificamente mencionadas na parte dos dados escrever da declaração SQL que serve como as colunas de origem na tabela de destino para a qual os dados são escritos. Estas colunas facilitam a linhagem de colunas.
policyName	TEXT	O nome totalmente qualificado da política.
policyId	NUMBER	Um identificador da política, que é único dentro de uma determinada conta e domínio. Este valor corresponde ao identificador de uma política de mascaramento no Exibição MASKING_POLICIES ou ao identificador de uma política de acesso a linhas no Exibição ROW_ACCESS_POLICIES
policyKind	TEXT	MASKING_POLICY ou ROW_ACCESS_POLICY
argumentoSignature	TEXT	O nome e o tipo de dados para cada argumento na UDF ou procedimento armazenado.
dataType		O tipo de dados do valor de retorno para uma UDF ou procedimento armazenado. Este valor ajuda a diferenciar duas ou mais UDFs com o mesmo nome, mas tipos de retorno diferentes.

Os campos para a coluna OBJECT_MODIFIED_BY_DDL são descritos abaixo.

Campo	Tipo de dados	Descrição
objectDomain	TEXT	O domínio do objeto definido ou modificado pela operação DDL, que inclui todos os objetos que podem ser marcados com tag e `MASKING POLICY`, `ROW ACCESS POLICY` e `TAG`.
objetId	NUMBER	Um identificador do objeto, que é único dentro de uma determinada conta e domínio, definido e modificado pela operação DDL.
objectName	TEXT	O nome totalmente qualificado do objeto definido ou modificado pela operação DDL.
operationType	TEXT	A palavra-chave SQL que especifica a operação na tabela, exibição ou coluna: `ALTER`, `CREATE`, `DROP`, `REPLACE` ou `UNDROP`.
properties	ARRAY	A matriz JSON que especifica as propriedades do objeto ou da coluna quando você cria, modifica, descarta ou desfaz o descarte do objeto ou da coluna. Existem dois tipos de propriedades: atômicas e compostas.

Para o campo properties:

Atômica: um valor por propriedade (por exemplo, um comment tem um único valor de cadeia de caracteres, a propriedade enabled é um booliano e tem um valor).
Composta: a propriedade tem múltiplos valores (por exemplo allowed_values para uma tag, política de mascaramento).

As propriedades compostas são registradas em uma matriz JSON. Por exemplo, se uma tabela contiver uma única coluna chamada EMAIL, a coluna será registrada da seguinte forma:

columns: {
  "email": {
    objectId: {
      "value": 1
    },
    "subOperationType": "ADD"
  }
}

Copy

O valor subOperationType pode ser um dos seguintes:

ADD especifica a adição de uma propriedade composta (por exemplo, adicionar uma coluna, definir valores permitidos).
DROP especifica a remoção de uma propriedade composta.
ALTER especifica a modificação de uma propriedade composta.

O objectId especifica o identificador para a coluna ou objeto, exceto para valores de tag permitidos que não possuem um identificador.

Notas de uso¶

A latência da visualização pode ser de até 180 minutos (3 horas).
Esta exibição do Account Usage pode ser usada para consultar o histórico de acesso agregado dos objetos Snowflake (por exemplo, tabela, exibição, coluna) nos últimos 365 dias (1 ano).