Synopsis
SET variable { TO | = } { 'value' | DEFAULT }
SET TIME ZONE { 'timezone' | LOCAL | DEFAULT }
SET TRANSACTION ISOLATION LEVEL { READ COMMITTED | SERIALIZABLE }
|
Inputs (Valores de entrada)
- variable
Parámetro glogal que se quiere fijar.
- value
Nuevo valor del parámetro. Se puede utilizar el valor DEFAULT para especificar que se devuelve el parámetro a su valor de defecto.
Las variables posibles y los valores permitidos son:
- CLIENT_ENCODING | NAMES
Fija la codificación para clientes mult-byte. Los parámetros son:
- value
Fija la codificación de cliente multi-byte a: value. La codificación especificada debe estar soportada por el servidor.
Esta opción solo es utilizable si el soporte MULTIBYE se autorizó durante el paso de configuración en la construcción de Postgres.
- DateStyle
Fija el estilo de representación de fecha/hora. Afecta al formato de salida, y en algunos casos puede afectar a la interpretación de la entrada.
- ISO
utiliza fechas y horas de estilo ISO 8601.
- SQL
utiliza fechas y horas de estilo Oracle/Ingres.
- Postgres
utiliza el formato tradicional de Postgres.
- European
utiliza dd/mm/yyyy para la representación numérica de las fechas.
- NonEuropean
utiliza mm/dd/yyyy para la representación numérica de las fechas.
- German
utiliza dd.mm.yyyy para la representación numérica de las fechas.
- US
igual que 'NonEuropean'
- DEFAULT
recupera los valores de defecto ('US,Postgres')
La inicialización del formato de la fecha se puede hacer:
Fijando la variable de entorno PGDATESTYLE. Si PGDATESTYLE se fija en el ambiente de una aplicación de un cliente basado en libpq, libpq fijará automáticamente DATESTYLE al valor de PGDATESTYLE durante el arranque de la conexión. Ejecutando postmastes utilizando la opción -o -e se fijan las fechas a la convención Europea. Nótese que esto afecta sólo a algunas combinaciones de estilos de fechas; por ejemplo, el estily ISO no se ve afectado por este parámetro. Cambiando las variables en src/backend/utils/init/globals.c. Las variables de globals.c que se pueden cambiar son:
bool EuroDates = false | true int DateStyle = USE_ISO_DATES | USE_POSTGRES_DATES | USE_SQL_DATES | USE_GERMAN_DATES - SERVER_ENCODING
Fija la codificación multi-byte para el servidor.
- value
Fija la codificación multi-bye para el servidor.
Esta opción sólo está disponible si se habilitó el soporte MULTIBYTE durante el paso de configuración de la construcción de Postgres.
- TIMEZONE
Los valores posibles para timezone dependen de su sistema operativo. Por ejemplo, en Linux /usr/lib/zoneinfo contiene la base de datos de zonas horarias.
Aquí tiene algunos valores válidos para zonas horarias:
- 'PST8PDT'
situa la zona horaria de California.
- 'Portugal'
sitúa la zona horaria de Portugal.
- 'Europe/Rome'
sitúa la zona horaria de Italia.
- DEFAULT
fija la zona horaria a su valor local. (el valor de la variable de entorno TZ).
Si se especifica una zona horaria invalida, será fijada a GMT (en la mayoría de sistemas en cualquier caso).
La segunda sistaxis mostrada más arriba, permite fijar la zona horaria con una sintaxis similar a SET TIME ZONE de SQL92. La palabra clave LOCAL es sólo un formato alternativo a DEFAULT para mantener la compatibilidad con SQL92.
Si la variable de entorno PGTZ se fija en el ambiente de la aplicación de un cliente basado en libpq (en el ambiente del frontend), libpq fijará automáticamente TIMEZONE al valor de PGTZ durante el arranque de la conexión.
- TRANSACTION ISOLATION LEVEL
Fija el nivel de aislamiento para la transacción actual.
- READ COMMITTED
Las consultas de la transacción actual leen sólo filas aseguradas (committed) antes de empezar una consulta. READ COMMITTED es el valor de defecto.
El estandar SQL92 requiere que se fije el valor de aislamiento de defecto a SERIALIZABLE.
- SERIALIZABLE
Las consultas de la transacción llen sólo fila aseguradas antes de la primera instrucción DML (SELECT/INSERT/DELETE/UPDATE/FETCH/COPY_TO) que se ejecute en esta transacción.
Hay también varios parámetros internos o de optimización que se pueden especificar con el comando SET:
- RANDOM_PAGE_COST
Fija la estimación del optimizador del coste de una página de disco leída no secuencialmente. Eso se mide como un múltiplo del coste de una lectura de página secuencial.
- float8
Fija el coste de un acceso aleatorio a un página al valor punto flotante especificado.
- CPU_TUPLE_COST
Fija la estimación que hará el optimizador del coste de procesar cada tupla durante una consulta. Esto se mide como una fracción del coste de una lectura secuencial de una página.
- float8
Fija el coste de proceso de CPU por tupla al valor de de punto flotante especificado.
- CPU_INDEX_TUPLE_COST
Fija la estimación que hará el optimizador sobre el coste de procesar cada tupla del índice durante el procesado de un barrido del índice (index scan). Se mide como una fracción del coste de una lectura secuencial de página.
- float8
Fija el coste de CPU de procesado por tupla de índice al valor de punto flotante especificado.
- CPU_OPERATOR_COST
Fija la estimación que hará el optimizador del coste de procesar cada operador en una cláusula WHERE. Esto se mide como una fracción del coste de un acceso secuencial a una página.
- float8
Fija le coste de CPU para procesar cada operador al valor de punto flotante especificado.
- EFFECTIVE_CACHE_SIZE
Fija la estimación que hará el optimizador sobre el tamaño efectivo de la caché en disco (es decir, la porción de la caché en disco del kernel que será utilizada por los ficheros de datos de Postgres). Esto se mide en páginas de disco, normalmente en piezas de 8 Kb.
- float8
Fija el tamaño estimado de la caché en el valor de punto flotante especificado.
- ENABLE_SEQSCAN
Habilita o inhabilita el uso por el planificador de tipos de planes de barrido secuencial. (No es posible suprimir completamente los barridos secuenciales, pero desactivando esta variable se disuade al planificador de utilizar uno de ellos si dispone de otro método utilizable).
- ON
Habilita el uso de barridos secuenciales (valor de defecto).
- OFF
Inhabilita el uso de barridos secuenciales.
- ENABLE_INDEXSCAN
Habilita o inhabilita el uso por el planificador de tipos de planes de barrido de índices.
- ON
Habilita el uso de barridos de índices (valor de defecto).
- OFF
Inhabilita el uso de barridos de índices.
- ENABLE_TIDSCAN
Habilita o inhabilita el uso por el planificador de tipos tipos de planes por barrido TID.
- ON
Habilita el uso de barridos TID (valor de defecto).
- OFF
Inhabilita el uso de barridos TID.
- ENABLE_SORT
Habilita o inhabilita el uso por el planificador pasos de ordenación explícita. (No es posible suprimir por completo las ordenaciones explititas, pero fijando en OFF esta variable disuade al planificador de usar uno cuando tiene otro método utilizable.)
- ON
Habilita el uso de ordenaciones (valor de defecto).
- OFF
Inhabilita el uso de ordenaciones.
- ENABLE_NESTLOOP
Habilita o inhabilita el uso por el planificador de planes de join de blucle anidado. (No es posible suprimer por completo las joins de bucle anidado, pero fijar en OFF esta variable disuade al planificador de utilizar uno de ellos si dispone de otro método).
- ON
Habilita el uso de joins de bucle anidado (valor de defecto).
- OFF
Inshabilita el uso de joins de bucle anidado.
- ENABLE_MERGEJOIN
Habilita o inhabilita el uso por el planificador de planes de tipo "enlace intercalado" (mergejoin).
- ON
Habilita el uso de enlaces intercalados (valor de defecto).
- OFF
Inhabilita el uso de enlaces intercalados.
- ENABLE_HASHJOIN
Habilita o inhabilita el uso por el planificador de planes de tipo enlace hash (hashjoin).
- ON
Habilita el uso de enlaces hash (valor de defecto).
- OFF
Inhabilita el uso de enlaces hash.
- GEQO
Fija el porcentaje de uso del algoritmo genérico del optimizador.
- ON
Habilita el algoritmo genérico del optimizador para instrucciones con 11 tablas o más. (Este es también el valor de defecto DEFAULT).
- ON=#
Toma un argumento entero para habilitar el algoritmo genérico para instrucciones con # o más tablas en la consulta.
- OFF
Inhabilita el algoritmo genérico del optimizador.
Vea el capítulo sobre GEQO de la Guía del Programador para obtener más información sobre la optimización de la consulta.
Si la variable de entorno PGGEQO se fija en el ambiente de usuario de un cliente basado en libpq, libpq automáticamente fijará GEQO al valor de PGGEQO durante el arranque de la conexión.
- KSQO
Key Set Query Optimizer (Optimizador de la Consulta Fijado por Clave) lleva al planificador de la consulta a convertir aquellas consultas cuyas cláusulas WHERE incluyan muchas cláusulas OR y AND (tales como "WHERE (a=1 AND b=2) OR (a=2 AND b=3) ...") en una consulta UNION. Este metodo puede ser más rápido que la implementación de defecto, pero no necesariamente produce exactamente el mismo resultado, puesto que UNION implítitamente añade una cláusula SELECT DISTINCT para eliminar las filas resultantes que sean identicas. KSQO se utiliza habitualmente cuando se trabaja con productos como MicroSoft Access, que tienden a generar las consultas de esta forma.
- ON
Habilita esta optimización.
- OFF
Inhabilita esta optimización (valor de defecto).
- DEFAULT
Equivalente a especificar SET KSQO='OFF'.
El algoritmo KSQO se utilizaba por ser absolutamente esencial para consultas con muchas cláusulas OR y AND, pero en Postgres 7.0 y posteriores, el planificador estandar manipula estas consultas correctamente.