Utilice el comando SET para establecer o cambiar los parámetros de tiempo de ejecución.
Emita este comando para cambiar los parámetros durante la conexión a una base de datos.
Sintaxis
Sintaxis para el comando
SET:
SET <parameter> { TO | = } { <value> | '<value>' | DEFAULT }
Entradas
El comando SET toma las siguientes entradas:
Tabla 1. Entradas de SET| Entrada |
Descripción |
| <parameter> |
Parámetro para el que se va a establecer un valor.
Dichos parámetros se describen en Parámetros: |
| <value> |
El valor que se quiere establecer para el parámetro. - Especifique DEFAULT para restablecer un parámetro a su valor predeterminado.
- Utilice comillas simples:
- Para valores que sean de más de 128 caracteres
- Para valores que contengan espacios en blanco o caracteres especiales, como los
signos más y menos.
- Para evitar que una serie de caracteres se convierta a las mayúsculas y minúsculas
predeterminadas.
Los valores posibles para cada parámetro se describen en Parámetros: |
Parámetros
El comando
SET puede utilizarse para establecer los parámetros siguientes:
- TIME ZONE
- Huso horario del sistema:
- '<timezone>'
- Una zona horaria especificada como horas con signo, con los minutos si se desea (por
ejemplo, '-08' o '+10:30'), que indica su desviación respecto a GMT. El signo
menos (-) indica que la zona está al oeste del meridiano de Greenwich. El rango
de zonas horarias es de '-12:59' a '+13:00'.
- LOCAL
- La zona horaria local.
Sintaxis:
SET TIME ZONE { TO | = } { '<timezone>' | DEFAULT }
- DATESTYLE
- La opción datestyle solo está pensada para la portabilidad de aplicaciones.
Para formatear los valores de fecha y hora, utilice la familia de funciones to_char.
Especifique
el estilo de la salida de fecha y hora, el subestilo o ambos:
- Estilo de salida de fecha y hora
- Los estilos de la salida de fecha y hora son:
- ISO
- Utilice fechas y hora en estilo ISO 8601 (AAAA-MM-DD para fechas, hh:mm:ss
para horas). Este es el valor predeterminado.
- SQL
- Utilice DD/MM/AAAA o MM/DD/AAAA para fechas y hh:mm:ss para horas. El
estilo de fecha que se utilice depende del subestilo.
- German
- Use DD.MM.AAAA para fechas y hh:mm:ss para horas.
- Subestilo
- El subestilo determina tanto el formato de fecha que se utiliza para
el formato de salida SQL como la interpretación preferida de entradas
de fecha ambiguas:
- European
- Utilice DD/MM/AAAA para las representaciones de fecha numéricas.
- US
- Utilice MM/DD/AAAA para las representaciones de fecha numéricas.
Sintaxis:
SET DATESTYLE { TO | = }
{ <output_style> | <substyle> | <output_style>,<substyle> | DEFAULT }
Puede inicializar el formato de fecha estableciendo la variable de entorno pgdatestyle. Si se establece pgdatestyle en el entorno de frontend de un cliente que se basa en libpq, libpq establece automáticamente datestyle en el valor pgdatestyle durante el inicio de conexión.
- RANDOM_SEED
- Semilla para el generador de números aleatorios. La función aleatoria
utiliza este valor. Se puede especificar un número de coma flotante en
el rango del 0 al 1. (Si se utiliza un número de fuera de este rango,
el producto se desborda silenciosamente). Luego el número se multiplica por 2(31)-1.
Sintaxis:
SET RANDOM_SEED { TO | = } { <value> | DEFAULT }
También puede establecer la fuente iniciando la función setseed: select setseed(value);
- LOAD_REPLAY_REGION
- Habilita la continuación de carga. El valor predeterminado es 0 (sin habilitar).
Si
se establece la LOAD_REPLAY_REGION (región de reproducción de carga), el sistema continúa
automáticamente una carga después de que el sistema haya hecho una pausa debido a una
migración tras error o al restablecimiento de la SPU.
La región de reproducción se utiliza para contener datos de entrada en bruto que se analizarán,
se convertirán, se empaquetarán en registros binarios y se enviarán a sus SPU
respectivos que no se hayan confirmado previamente. Cuando el sistema se reanuda
desde un estado de pausa, vuelve a analizar, a convertir, a empaquetar y a enviar
todos los datos en bruto de esta región a las SPU.
Sintaxis:
SET LOAD_REPLAY_REGION { TO | = } { 0 | 1 | DEFAULT }
- CLIENT_USER_ID
- ID de usuario con el que se ejecuta el cliente. El valor puede tener
hasta 1024 caracteres. El valor predeterminado es una serie vacía ('').
Sintaxis:
SET CLIENT_USER_ID { TO | = } { <value> | '<value>' | DEFAULT }
- CLIENT_WORKSTATION_NAME
- Nombre de host de la estación de trabajo en la que se ejecuta el cliente. El
valor puede tener hasta 1024 caracteres. El valor predeterminado es una serie vacía
('').
Sintaxis:
SET CLIENT_WORKSTATION_NAME { TO | = } { <value> | '<value>' | DEFAULT }
- CLIENT_APPLICATION_NAME
- Nombre del cliente. El valor puede tener hasta 1024 caracteres.
El valor predeterminado es una serie vacía ('').
Sintaxis:
SET CLIENT_APPLICATION_NAME { TO | = } { <value> | '<value>' | DEFAULT }
- CLIENT_ACCOUNTING_STRING
- Serie de contabilidad. El valor puede tener hasta 1024 caracteres.
El valor predeterminado es una serie vacía ('').
Sintaxis:
SET CLIENT_ACCOUNTING_STRING { TO | = } { <value> | '<value>' | DEFAULT }
Salidas
El comando SET tiene las siguientes salidas:
Tabla 2. Salidas de SET| Salida |
Descripción |
| SET VARIABLE |
El comando se ha ejecutado correctamente. |
| ERROR: not a valid option name: name |
El parámetro que se ha intentado establecer no existe. |
| ERROR: permission denied |
No cuenta con el acceso necesario. Debe ser el administrador para tener acceso a ciertos valores. |
| ERROR: name can only be set at start-up |
Ciertos parámetros se han fijado después de iniciarse el servidor. |
Privilegios
Es necesario ser
administrador o contar con los privilegios de objeto adecuados.
Uso
Los ejemplos siguientes
proporcionan muestras de uso.
- Definir la zona horaria a la hora estándar del Este (EST) de EE.UU.:
MYDB.MYSCH(USER)=> SET TIME ZONE TO '-05';
- Definir el subestilo a europeo (European):
MYDB.MYSCH(USER)=> SET DATESTYLE TO European;
- Definir el estilo de salida a ISO y el subestilo a US:
MYDB.MYSCH(USER)=> SET DATESTYLE TO ISO,US;
- Establecer como semilla para el generador de números aleatorios el número 0.45:
MYDB.MYSCH(USER)=> SET RANDOM_SEED=0.45;
- Habilitar la continuación de carga:
MYDB.MYSCH(USER)=> SET LOAD_REPLAY_REGION=1;
- Establecer el nombre de la estación de trabajo del cliente a homer.sampcorp.com e
impedir que el valor se convierta a las mayúsculas y minúsculas predeterminadas:
MYDB.MYSCH(USER)=> SET CLIENT_WORKSTATION_NAME TO 'homer.sampcorp.com'