SET

Establece el valor de un parámetro de configuración de un servidor. Utilice el comando SET para invalidar un valor solo mientras dure la sesión o la transacción actual.

Utilice el comando RESET para devolver un parámetro a su valor predeterminado.

Puede cambiar los parámetros de configuración del servidor de varias maneras. Para obtener más información, consulte Modificación de la configuración del servidor.

Sintaxis

SET { [ SESSION | LOCAL ]
{ SEED | parameter_name } { TO | = }
{ value | 'value' | DEFAULT } |
SEED TO value }

La siguiente instrucción establece el valor de una variable de contexto de sesión.

SET { [ SESSION | LOCAL ]
variable_name { TO | = }
{ value | 'value'  }

Parámetros

Ejemplos

Cambio de un parámetro en la sesión actual

En el siguiente ejemplo, se establece el estilo de fecha:

set datestyle to 'SQL,DMY';

Establecimiento de un grupo de consultas para la administración de cargas de trabajo

Si los grupos de consultas están enumerados en la definición de una cola como parte de la configuración WLM del clúster, puede establecer el parámetro QUERY_GROUP con el nombre de un grupo de consultas enumerado. Las consultas posteriores se asignan a la cola de la consulta asociada. El ajuste QUERY_GROUP permanece en vigor durante la sesión o hasta que se aplica un comando RESET QUERY_GROUP.

Este ejemplo ejecuta dos consultas como parte de la "prioridad" del grupo de consultas y, luego, restablece el grupo de consultas.

set query_group to 'priority';
select tbl, count(*)from stv_blocklist;
select query, elapsed, substring from svl_qlog order by query desc limit 5;
reset query_group;

Para obtener más información, consulte Administración de la carga de trabajo.

Cambio del espacio de nombres de identidad predeterminado para la sesión

Un usuario de la base de datos puede establecer default_identity_namespace. En este ejemplo, se muestra cómo usar SET SESSION para invalidar la configuración durante la sesión actual y, a continuación, mostrar el nuevo valor del proveedor de identidades. Esto se utiliza con más frecuencia cuando utiliza un proveedor de identidades con Redshift e IAM Identity Center. Para obtener más información sobre cómo usar un proveedor de identidades con Redshift, consulte Conectar Redshift con IAM Identity Center para ofrecer a los usuarios una experiencia de inicio de sesión único.

SET SESSION default_identity_namespace = 'MYCO';
         
SHOW default_identity_namespace;

Tras ejecutar el comando, puede ejecutar una instrucción GRANT o CREATE como la siguiente:

GRANT SELECT ON TABLE mytable TO alice;

GRANT UPDATE ON TABLE mytable TO salesrole;
         
CREATE USER bob password 'md50c983d1a624280812631c5389e60d48c';

En este caso, el efecto de establecer el espacio de nombres de identidad predeterminado equivale a anteponer cada identidad con el espacio de nombres. En este ejemplo, alice se sustituye por MYCO:alice. Para obtener más información acerca de los ajustes relacionados con la configuración de Redshift con IAM Identity Center, consulte ALTER SYSTEM y MODIFICAR PROVEEDOR DE IDENTIDADES.

Establecimiento de una etiqueta para un grupo de consultas

El parámetro QUERY_GROUP define una etiqueta para una o más consultas que se ejecutan en la misma sesión después de un comando SET. A su vez, se registra esta etiqueta cuando se ejecutan las consultas y se puede utilizar para limitar los resultados que devuelven las tablas de sistema STL_QUERY y STV_INFLIGHT, además de la vista SVL_QLOG.

show query_group;
query_group
-------------
unset
(1 row)

set query_group to '6 p.m.';


show query_group;
query_group
-------------
6 p.m.
(1 row)

select * from sales where salesid=500;
salesid | listid | sellerid | buyerid | eventid | dateid | ...
---------+--------+----------+---------+---------+--------+-----
500 |    504 |     3858 |    2123 |    5871 |   2052 | ...
(1 row)

reset query_group;

select query, trim(label) querygroup, pid, trim(querytxt) sql
from stl_query
where label ='6 p.m.';
query | querygroup |  pid  |                  sql
-------+------------+-------+----------------------------------------
57 | 6 p.m.     | 30711 | select * from sales where salesid=500;
(1 row)

Las etiquetas del grupo de consultas son un mecanismo útil para aislar consultas individuales o grupos de consultas que se ejecutan como parte de scripts. No es necesario identificar y rastrear las consultas por sus ID; puede rastrearlas por sus etiquetas.

Establecimiento de un valor de inicio para la generación aleatoria de números

En el siguiente ejemplo, se utiliza la opción SEED con SET para que la función RANDOM genere números en una secuencia predecible.

Primero, se devuelven tres valores enteros RANDOM sin establecer antes el valor SEED:

select cast (random() * 100 as int);
int4
------
6
(1 row)

select cast (random() * 100 as int);
int4
------
68
(1 row)

select cast (random() * 100 as int);
int4
------
56
(1 row)

Ahora, establezca el valor SEED en .25 y devuelva tres números RANDOM más:

set seed to .25;

select cast (random() * 100 as int);
int4
------
21
(1 row)

select cast (random() * 100 as int);
int4
------
79
(1 row)

select cast (random() * 100 as int);
int4
------
12
(1 row)

Finalmente, restablezca el valor SEED a .25 y verifique que RANDOM devuelva los mismos resultados que en las tres ejecuciones anteriores:

set seed to .25;

select cast (random() * 100 as int);
int4
------
21
(1 row)

select cast (random() * 100 as int);
int4
------
79
(1 row)

select cast (random() * 100 as int);
int4
------
12
(1 row)

En el siguiente ejemplo, se establece una variable de contexto personalizada.

SET app_context.user_id TO 123;
SET app_context.user_id TO 'sample_variable_value';