Categorias:

Funções do sistema (Informações do sistema)

SYSTEM$CLUSTERING_RATIO — Obsoleto

Calcula a razão de clustering para uma tabela, com base em uma ou mais colunas da tabela. A relação é um número de 0 a 100. Quanto maior a proporção, melhor clusterizada é a tabela.

A razão de clustering para uma tabela pode ser calculada usando qualquer coluna na tabela ou colunas que tenham sido explicitamente definidas como uma chave de clustering para a tabela. Uma chave de clustering pode ser definida para uma tabela usando CREATE TABLE ou ALTER TABLE.

Para obter mais informações sobre a razão de clustering e chaves de clustering, consulte Explicação das estruturas de tabela do Snowflake.

Sintaxe

SYSTEM$CLUSTERING_RATIO( '<table_name>' , '( <col1> [ , <col2> ... ] )' [ , '<predicate>' ] )

Argumentos

table_name

Tabela para a qual você deseja calcular a razão de clustering.

col1 [ , col2 ... ]

Coluna(s) na tabela utilizada(s) para calcular a razão de clustering:

  • Para uma tabela sem chave de clustering, este argumento é necessário. Se este argumento for omitido, um erro é devolvido.

  • Para uma tabela com uma chave de clustering, este argumento é opcional; se o argumento for omitido, o Snowflake usa a chave de clustering definida para calcular a razão.

Nota

Você pode usar este argumento para calcular a razão de qualquer coluna da tabela, independentemente da chave de clustering definida para a tabela.

predicate

Cláusula que filtra o intervalo de valores nas colunas nas quais se calcula a razão de clustering. Observe que predicate não utiliza uma palavra-chave WHERE no início da cláusula.

Notas de uso

  • Todos os argumentos são cadeias de caracteres (ou seja, devem ser colocados entre aspas simples).

  • Se predicate contém uma cadeia de caracteres, a cadeia de caracteres deve ser delimitada por aspas simples, que então devem ser escapadas usando aspas simples. Por exemplo:

    SYSTEM$CLUSTERING_RATIO( ... , 'col1 = 100 and col2 = ''A''' )

Exemplos

Calcular a razão de clustering para uma tabela usando duas colunas na tabela:

SELECT SYSTEM$CLUSTERING_RATIO('t2', '(col1, col3)');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T2') |
|-------------------------------|
|                          77.1 |
+-------------------------------+

Calcular a razão de clustering para uma tabela usando duas colunas na tabela e um predicado em uma das colunas:

SELECT SYSTEM$CLUSTERING_RATIO('t2', '(col1, col2)', 'col1 = ''A''');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T2') |
|-------------------------------|
|                          87.7 |
+-------------------------------+

Calcular a razão de clustering para uma tabela usando a chave de clustering definida para a tabela:

SELECT SYSTEM$CLUSTERING_RATIO('t1');

+-------------------------------+
| SYSTEM$CLUSTERING_RATIO('T1') |
|-------------------------------|
|                         100.0 |
+-------------------------------+