Literais e variáveis como identificadores com a sintaxe IDENTIFIER()¶

Como usar a sintaxe IDENTIFIER() com literais de cadeia de caracteres¶

Esses exemplos mostram como fazer referência a um objeto quando um literal de cadeia de caracteres contém o identificador do objeto.

Crie um banco de dados:

CREATE OR REPLACE DATABASE IDENTIFIER('my_db');

+--------------------------------------+
| status                               |
|--------------------------------------|
| Database MY_DB successfully created. |
+--------------------------------------+

Criação de um esquema:

CREATE OR REPLACE SCHEMA IDENTIFIER('my_schema');

+----------------------------------------+
| status                                 |
|----------------------------------------|
| Schema MY_SCHEMA successfully created. |
+----------------------------------------+

Crie uma tabela usando um nome de tabela que não diferencia maiúsculas de minúsculas, especificado em uma cadeia de caracteres com o nome totalmente qualificado:

CREATE OR REPLACE TABLE IDENTIFIER('my_db.my_schema.my_table') (c1 number);

+--------------------------------------+
| status                               |
|--------------------------------------|
| Table MY_TABLE successfully created. |
+--------------------------------------+

Crie uma tabela usando um nome de tabela que diferencia maiúsculas de minúsculas especificado em uma cadeia de caracteres entre aspas duplas:

CREATE OR REPLACE TABLE IDENTIFIER('"my_table"') (c1 number);

+--------------------------------------+
| status                               |
|--------------------------------------|
| Table my_table successfully created. |
+--------------------------------------+

Mostre as tabelas em um esquema:

SHOW TABLES IN SCHEMA IDENTIFIER('my_schema');

+-------------------------------+----------+---------------+-------------+-------+---------+---------+
| created_on                    | name     | database_name | schema_name | kind  | comment | ...     |
|-------------------------------+----------+---------------+-------------+-------+---------+---------|
| 2024-07-03 08:55:11.992 -0700 | MY_TABLE | MY_DB         | MY_SCHEMA   | TABLE |         | ...     |
| 2024-07-03 08:56:00.604 -0700 | my_table | MY_DB         | MY_SCHEMA   | TABLE |         | ...     |
+-------------------------------+----------+---------------+-------------+-------+---------+---------+

Como usar a sintaxe IDENTIFIER() com variáveis de sessão¶

Esses exemplos mostram como usar uma variável de sessão que tem um nome de tabela ou de esquema.

Defina uma variável de sessão para um nome de esquema:

SET schema_name = 'my_db.my_schema';

Defina uma variável de sessão para um nome de tabela:

SET table_name = 'my_table';

Especifique o esquema para a sessão atual:

USE SCHEMA IDENTIFIER($schema_name);

Insira os valores em uma tabela:

INSERT INTO IDENTIFIER($table_name) VALUES (1), (2), (3);

Consulte uma tabela:

SELECT * FROM IDENTIFIER($table_name) ORDER BY 1;

+----+
| C1 |
|----|
|  1 |
|  2 |
|  3 |
+----+

Este exemplo mostra como usar uma variável de sessão com um nome de função.

1. Crie a função speed_of_light:

   CopyExpand

   CREATE FUNCTION speed_of_light() 
   RETURNS INTEGER
   AS
     $$
     299792458
     $$;
   

   Show lessSee more

   Scroll to top

2. Chame a função pelo nome:

   CopyExpand

   SELECT speed_of_light();
   

   Show lessSee more

   Scroll to top

   Expand

   +------------------+
   | SPEED_OF_LIGHT() |
   |------------------|
   |        299792458 |
   +------------------+
   

   Show lessSee more

   Scroll to top

3. Chame a função usando a sintaxe IDENTIFIER():

   CopyExpand

   SET my_function_name = 'speed_of_light';
   

   Show lessSee more

   Scroll to top

   CopyExpand

   SELECT IDENTIFIER($my_function_name)();
   

   Show lessSee more

   Scroll to top

   Expand

   +---------------------------------+
   | IDENTIFIER($MY_FUNCTION_NAME)() |
   |---------------------------------|
   |                       299792458 |
   +---------------------------------+
   

   Show lessSee more

   Scroll to top

Como usar a sintaxe IDENTIFIER() com variáveis de vinculação¶

Esses exemplos mostram como usar as variáveis de vinculação para identificar objetos.

Este exemplo mostra como vincular um nome de função em JDBC. A função é denominada speed_of_light.

String sql_command;

// Create a Statement object to use later.
System.out.println("Create JDBC statement.");
Statement statement = connection.createStatement();
System.out.println("Create function.");
sql_command = "CREATE FUNCTION speed_of_light() RETURNS INTEGER AS $$ 299792458 $$";
statement.execute(sql_command);

System.out.println("Create prepared statement.");
sql_command = "SELECT IDENTIFIER(?)()";
PreparedStatement ps = connection.prepareStatement(sql_command);
// Bind
ps.setString(1, "speed_of_light");
ResultSet rs = ps.executeQuery();
if (rs.next()) {
  System.out.println("Speed of light (m/s) = " + rs.getInt(1));
}

Os exemplos a seguir mostram uma variedade de instruções SQL que podem usar vinculação, e uma variedade de objetos de banco de dados que podem ser vinculados (incluindo nomes de esquemas e nomes de tabelas):

USE SCHEMA IDENTIFIER(?);

CREATE OR REPLACE TABLE IDENTIFIER(?) (c1 NUMBER);

INSERT INTO IDENTIFIER(?) values (?), (?), (?);

SELECT t2.c1
  FROM IDENTIFIER(?) AS t1,
       IDENTIFIER(?) AS t2
  WHERE t1.c1 = t2.c1 AND t1.c1 > (?);

DROP TABLE IDENTIFIER(?);

Como usar a sintaxe IDENTIFIER() com variáveis do Snowflake Scripting¶

Este exemplo mostra como usar uma variável Snowflake Scripting para um nome de tabela em uma instrução SELECT:

BEGIN
  LET res RESULTSET := (SELECT COUNT(*) AS COUNT FROM IDENTIFIER(:table_name));
  ...