Constantes SQLSRV
Este tema enumera las constantes definidas por el Controlador de SQL Server para PHP.
Constantes ERR
En la siguiente tabla se muestran las constantes que se usan para especificar si sqlsrv_errors devuelve errores, advertencias o ambos.
| Valor | Descripción |
|---|---|
SQLSRV_ERR_ALL |
Se devuelven los errores y las advertencias generados en la última llamada a una función sqlsrv. Éste es el valor predeterminado. |
SQLSRV_ERR_ERRORS |
Se devuelven los errores generados en la última llamada a una función sqlsrv. |
SQLSRV_ERR_WARNINGS |
Se devuelven las advertencias generadas en la última llamada a una función sqlsrv. |
Constantes FETCH
En la tabla siguiente se muestran las constantes usadas para especificar el tipo de matriz devuelta por sqlsrv_fetch_array.
| Constante SQLSRV | Descripción |
|---|---|
SQLSRV_FETCH_ASSOC |
sqlsrv_fetch_array devuelve la siguiente fila de datos como matriz asociativa. |
SQLSRV_FETCH_BOTH |
sqlsrv_fetch_array devuelve la siguiente fila de datos como matriz con ambas claves: numérica y asociativa. Éste es el valor predeterminado. |
SQLSRV_FETCH_NUMERIC |
sqlsrv_fetch_array devuelve la siguiente fila de datos como matriz indizada numéricamente. |
Para obtener más información sobre el uso de estas constantes, vea Cómo recuperar datos como una matriz.
Registrar constantes
En esta sección se muestran las constantes utilizadas para cambiar la configuración de registro con sqlsrv_configure. Para obtener más información acerca de la actividad de registro, vea Actividad de registro.
En la tabla siguiente se muestran las constantes que se pueden usar como valor para la configuración de LogSubsystems:
| Constante SQLSRV (entero equivalente entre paréntesis) | Descripción |
|---|---|
SQLSRV_LOG_SYSTEM_ALL (-1) |
Activa el registro de todos los subsistemas. |
SQLSRV_LOG_SYSTEM_CONN (2) |
Activa el registro de actividad de conexión. |
SQLSRV_LOG_SYSTEM_INIT (1) |
Activa el registro de actividad de inicialización. |
SQLSRV_LOG_SYSTEM_OFF (0) |
Desactiva el registro. |
SQLSRV_LOG_SYSTEM_STMT (4) |
Activa el registro de actividad de instrucción. |
SQLSRV_LOG_SYSTEM_UTIL (8) |
Activa el registro de actividad de funciones de error (como handle_error y handle_warning). |
En la tabla siguiente se muestran las constantes que se pueden usar como valor para la configuración de LogSeverity:
| Constante SQLSRV (entero equivalente entre paréntesis) | Descripción |
|---|---|
SQLSRV_LOG_SEVERITY_ALL (-1) |
Especifica los errores, advertencias y avisos que se van a registrar. |
SQLSRV_LOG_SEVERITY_ERROR (1) |
Especifica los errores que se van a registrar. |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
Especifica los avisos que se van a registrar. |
SQLSRV_LOG_SEVERITY_WARNING (2) |
Especifica las advertencias que se van a registrar. |
Constantes que admiten valores NULL
En la siguiente tabla se muestran las constantes que puede usar para determinar si una columna admite valores NULL o no. O bien, si esta información no está disponible. Puede comparar el valor de la clave Nullable devuelto por sqlsrv_field_metadata para determinar el estado de aceptación de valores NULL de la columna.
| Constante SQLSRV (entero equivalente entre paréntesis) | Descripción |
|---|---|
SQLSRV_NULLABLE_YES (0) |
La columna admite valores NULL. |
SQLSRV_NULLABLE_NO (1) |
La columna no admite valores NULL. |
SQLSRV_NULLABLE_UNKNOWN (2) |
No se sabe si la columna admite valores NULL. |
Constantes PARAM
La siguiente lista contiene las constantes para especificar la dirección del parámetro cuando se llama a sqlsrv_query o sqlsrv_prepare.
| Constante SQLSRV | Descripción |
|---|---|
SQLSRV_PARAM_IN |
Indica un parámetro de entrada. |
SQLSRV_PARAM_INOUT |
Indica un parámetro bidireccional. |
SQLSRV_PARAM_OUT |
Indica un parámetro de salida. |
Constantes PHPTYPE
En la tabla siguiente se muestran las constantes que se utilizan para describir los tipos de datos de PHP. Para obtener información sobre estos tipos de datos, vea Tipos de PHP (en inglés).
| Constante SQLSRV | Tipo de datos de PHP |
|---|---|
SQLSRV_PHPTYPE_INT |
Entero |
SQLSRV_PHPTYPE_DATETIME |
Datetime |
SQLSRV_PHPTYPE_FLOAT |
Float |
SQLSRV_PHPTYPE_STREAM(<codificación>1) |
Stream |
SQLSRV_PHPTYPE_STRING(<codificación>1) |
String |
1. SQLSRV_PHPTYPE_STREAM y SQLSRV_PHPTYPE_STRING aceptan un parámetro que especifica la codificación de la secuencia. La tabla siguiente contiene las constantes SQLSRV que son parámetros aceptables y una descripción de la codificación correspondiente.
| Constante SQLSRV | Descripción |
|---|---|
SQLSRV_ENC_BINARY |
Los datos se devuelven como una secuencia de bytes sin procesar desde el servidor sin realización de codificación ni traducción. |
SQLSRV_ENC_CHAR |
Los datos se devuelven en caracteres de 8 bits como se especifica en la página de códigos de la configuración regional de Windows que se establece en el sistema. Los caracteres de varios bytes o los que no se asignen en esta página de códigos se sustituye por un signo de interrogación de cierre (?) de un solo byte . |
"UTF-8" |
Los datos se devuelven en la codificación UTF-8. Esta constante se ha agregado en la versión 1.1 del Controlador de SQL Server para PHP. Para obtener más información acerca de la compatibilidad con UTF-8, vea Cómo enviar y recuperar datos UTF-8 mediante la compatibilidad integrada con UTF-8. |
Nota
Cuando use SQLSRV_PHPTYPE_STREAM o SQLSRV_PHPTYPE_STRING, se debe especificar la codificación. Si no se proporciona ningún parámetro, se devolverá un error.
Para obtener más información sobre estas constantes, vea Cómo especificar tipos de datos de PHP, Cómo recuperar datos de caracteres como una secuencia.
Constantes SQLTYPE
En la tabla siguiente se muestran las constantes que se utilizan para describir los tipos de datos de SQL Server. Algunas constantes requieren parámetros que corresponden a la precisión, escala y/o longitud. Para obtener información sobre los tipos de datos de SQL Server, vea Tipos de datos (Transact-SQL). Para obtener información sobre la precisión, escala y longitud, vea Precisión, escala y longitud (Transact-SQL).
| Constante SQLSRV | Tipo de datos de SQL Server |
|---|---|
SQLSRV_SQLTYPE_BIGINT |
bigint |
SQLSRV_SQLTYPE_BINARY |
binary |
SQLSRV_SQLTYPE_BIT |
bit |
SQLSRV_SQLTYPE_CHAR($charCount) |
char |
SQLSRV_SQLTYPE_DATE |
date4 |
SQLSRV_SQLTYPE_DATETIME |
datetime |
SQLSRV_SQLTYPE_DATETIME2 |
datetime24 |
SQLSRV_SQLTYPE_DATETIMEOFFSET |
datetimeoffset4 |
SQLSRV_SQLTYPE_DECIMAL($precision, $scale) |
decimal |
SQLSRV_SQLTYPE_FLOAT |
float |
SQLSRV_SQLTYPE_IMAGE |
image1 |
SQLSRV_SQLTYPE_INT |
int |
SQLSRV_SQLTYPE_MONEY |
money |
SQLSRV_SQLTYPE_NCHAR($charCount) |
nchar |
SQLSRV_SQLTYPE_NUMERIC($precision, $scale) |
numeric |
SQLSRV_SQLTYPE_NVARCHAR($charCount) |
nvarchar |
SQLSRV_SQLTYPE_NVARCHAR('max') |
nvarchar(MAX) |
SQLSRV_SQLTYPE_NTEXT |
ntext2 |
SQLSRV_SQLTYPE_REAL |
real |
SQLSRV_SQLTYPE_SMALLDATETIME |
smalldatetime |
SQLSRV_SQLTYPE_SMALLINT |
smallint |
SQLSRV_SQLTYPE_SMALLMONEY |
smallmoney |
SQLSRV_SQLTYPE_TEXT |
text3 |
SQLSRV_SQLTYPE_TIME |
time4 |
SQLSRV_SQLTYPE_TIMESTAMP |
timestamp |
SQLSRV_SQLTYPE_TINYINT |
tinyint |
SQLSRV_SQLTYPE_UNIQUEIDENTIFIER |
uniqueidentifier |
SQLSRV_SQLTYPE_UDT |
UDT |
SQLSRV_SQLTYPE_VARBINARY($byteCount) |
varbinary |
SQLSRV_SQLTYPE_VARBINARY('max') |
varbinary(MAX) |
SQLSRV_SQLTYPE_VARCHAR($charCount) |
varchar |
SQLSRV_SQLTYPE_VARCHAR('max') |
varchar(MAX) |
SQLSRV_SQLTYPE_XML |
xml |
- Se trata de un tipo heredado que se asigna al tipo varbinary(max).
- Se trata de un tipo heredado que se asigna al tipo nvarchar más reciente.
- Se trata de un tipo heredado que se asigna al tipo varchar más reciente.
- La compatibilidad con este tipo se ha agregado en la versión 1.1 del Controlador de SQL Server para PHP.
En la tabla siguiente se muestran las constantes SQLTYPE que aceptan parámetros y el intervalo de valores permitido por el parámetro.
| SQLTYPE | Parámetro | Intervalo que se puede permitir para el parámetro |
|---|---|---|
SQLSRV_SQLTYPE_CHAR, SQLSRV_SQLTYPE_VARCHAR |
charCount |
1 - 8000 |
SQLSRV_SQLTYPE_NCHAR, SQLSRV_SQLTYPE_NVARCHAR |
charCount |
1 - 4000 |
SQLSRV_SQLTYPE_BINARY, SQLSRV_SQLTYPE_VARBINARY |
byteCount |
1 - 8000 |
SQLSRV_SQLTYPE_DECIMAL, SQLSRV_SQLTYPE_NUMERIC |
precision |
1 - 38 |
SQLSRV_SQLTYPE_DECIMAL, SQLSRV_SQLTYPE_NUMERIC |
scale |
1 - precisión |
Constantes del nivel de aislamiento de transacción
La clave TransactionIsolation, que se usa con sqlsrv_connect, acepta una de las siguientes constantes:
- SQLSRV_TXN_READ_UNCOMMITTED
- SQLSRV_TXN_READ_COMMITTED
- SQLSRV_TXN_REPEATABLE_READ
- SQLSRV_TXN_SNAPSHOT
- SQLSRV_TXN_SERIALIZABLE
Constantes de cursor y desplazamiento
Las siguientes constantes especifican el tipo de cursor que se puede usar en un conjunto de resultados:
- SQLSRV_CURSOR_FORWARD
- SQLSRV_CURSOR_STATIC
- SQLSRV_CURSOR_DYNAMIC
- SQLSRV_CURSOR_KEYSET
Las siguientes constantes especifican qué fila se debe seleccionar en el conjunto de resultados:
- SQLSRV_SCROLL_NEXT
- SQLSRV_SCROLL_PRIOR
- SQLSRV_SCROLL_FIRST
- SQLSRV_SCROLL_LAST
- SQLSRV_SCROLL_ABSOLUTE
- SQLSRV_SCROLL_RELATIVE
Para obtener más información acerca del uso de estas constantes, vea Especificar un tipo de cursor y seleccionar filas.