SQLSRV-Konstanten
In diesem Thema sind die von SQL Server-Treiber für PHP definierten Konstanten aufgeführt.
ERR-Konstanten
Die folgende Tabelle enthält die Konstanten, mit denen angegeben wird, ob sqlsrv_errors Fehler, Warnungen oder beides zurückgibt.
Wert | Beschreibung |
---|---|
SQLSRV_ERR_ALL |
Fehler und Warnungen, die beim letzten sqlsrv-Funktionsaufruf generiert wurden, werden zurückgegeben. Dies ist der Standardwert. |
SQLSRV_ERR_ERRORS |
Fehler, die beim letzten sqlsrv-Funktionsaufruf generiert wurden, werden zurückgegeben. |
SQLSRV_ERR_WARNINGS |
Warnungen, die beim letzten sqlsrv-Funktionsaufruf generiert wurden, werden zurückgegeben. |
FETCH-Konstanten
Die folgende Tabelle enthält die Konstanten, mit denen der Typ des von sqlsrv_fetch_array zurückgegebenen Arrays angegeben wird.
SQLSRV-Konstante | Beschreibung |
---|---|
SQLSRV_FETCH_ASSOC |
sqlsrv_fetch_array bewirkt, dass die nächste Datenzeile als assoziatives Array zurückgegeben wird. |
SQLSRV_FETCH_BOTH |
sqlsrv_fetch_array legt fest, dass die nächste Datenzeile sowohl als numerisches als auch als assoziatives Array zurückgegeben wird. Dies ist der Standardwert. |
SQLSRV_FETCH_NUMERIC |
sqlsrv_fetch_array gibt an, dass die nächste Datenzeile als numerisch indiziertes Array zurückgegeben wird. |
Weitere Informationen zum Verwenden dieser Konstanten finden Sie unter Vorgehensweise: Abrufen von Daten als Array.
Protokollierungskonstanten
In diesem Abschnitt werden die Konstanten beschrieben, die zum Ändern der Protokollierungseinstellungen mit sqlsrv_configure verwendet werden. Weitere Informationen zur Protokollierung von Aktivitäten finden Sie unter Protokollieren von Aktivitäten.
Die folgende Tabelle enthält die Konstanten, die als Werte für die LogSubsystems-Einstellung verwendet werden können:
SQLSRV-Konstante (entsprechende ganze Zahl in Klammern) | Beschreibung |
---|---|
SQLSRV_LOG_SYSTEM_ALL (-1) |
Aktiviert die Protokollierung aller Subsysteme. |
SQLSRV_LOG_SYSTEM_CONN (2) |
Aktiviert die Protokollierung der Verbindungsaktivitäten. |
SQLSRV_LOG_SYSTEM_INIT (1) |
Aktiviert die Protokollierung der Initialisierungsaktivitäten. |
SQLSRV_LOG_SYSTEM_OFF (0) |
Deaktiviert die Protokollierung. |
SQLSRV_LOG_SYSTEM_STMT (4) |
Aktiviert die Protokollierung der Anweisungsaktivitäten. |
SQLSRV_LOG_SYSTEM_UTIL (8) |
Aktiviert die Protokollierung der Fehlerfunktionsaktivitäten (z. B. handle_error und handle_warning). |
Die folgende Tabelle enthält die Konstanten, die als Werte für die LogSeverity-Einstellung verwendet werden können:
SQLSRV-Konstante (entsprechende ganze Zahl in Klammern) | Beschreibung |
---|---|
SQLSRV_LOG_SEVERITY_ALL (-1) |
Gibt an, dass Fehler, Warnungen und Hinweise protokolliert werden. |
SQLSRV_LOG_SEVERITY_ERROR (1) |
Gibt an, dass Fehler protokolliert werden. |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
Gibt an, dass Hinweise protokolliert werden. |
SQLSRV_LOG_SEVERITY_WARNING (2) |
Gibt an, dass Warnungen protokolliert werden. |
Auf NULL festlegbare Konstanten
Die folgende Tabelle enthält die Konstanten, mit denen Sie bestimmen können, ob eine Spalte auf den Wert NULL festgelegt werden kann oder ob diese Information nicht verfügbar ist. Durch einen Abgleich mit dem Wert des Nullable-Schlüssels, der von sqlsrv_field_metadata zurückgegeben wird, können Sie ermitteln, ob eine Spalte auf NULL festgelegt werden kann.
SQLSRV-Konstante (entsprechende ganze Zahl in Klammern) | Beschreibung |
---|---|
SQLSRV_NULLABLE_YES (0) |
Die Spalte ist auf NULL festlegbar. |
SQLSRV_NULLABLE_NO (1) |
Die Spalte ist nicht auf NULL festlegbar. |
SQLSRV_NULLABLE_UNKNOWN (2) |
Es ist nicht bekannt, ob die Spalte auf NULL festlegbar ist. |
PARAM-Konstanten
Die folgende Liste enthält die Konstanten zum Angeben der Parameterrichtung in Aufrufen von sqlsrv_query oder sqlsrv_prepare.
SQLSRV-Konstante | Beschreibung |
---|---|
SQLSRV_PARAM_IN |
Gibt einen Eingabeparameter an. |
SQLSRV_PARAM_INOUT |
Gibt einen bidirektionalen Parameter an. |
SQLSRV_PARAM_OUT |
Gibt einen Ausgabeparameter an. |
PHPTYPE-Konstanten
In der folgenden Tabelle sind die Konstanten aufgeführt, mit denen PHP-Datentypen beschrieben werden. Informationen zu den PHP-Datentypen finden Sie unter PHP-Typen.
SQLSRV-Konstante | PHP-Datentyp |
---|---|
SQLSRV_PHPTYPE_INT |
Integer |
SQLSRV_PHPTYPE_DATETIME |
Datetime |
SQLSRV_PHPTYPE_FLOAT |
Float |
SQLSRV_PHPTYPE_STREAM (<Codierung>1) |
Stream |
SQLSRV_PHPTYPE_STRING (<Codierung>1) |
String |
1. SQLSRV_PHPTYPE_STREAM und SQLSRV_PHPTYPE_STRING akzeptieren einen Parameter, der die Datenstromcodierung angibt. Die folgende Tabelle enthält die SQLSRV-Konstanten, die als Parameter akzeptiert werden, und eine Beschreibung der zugehörigen Codierung.
SQLSRV-Konstante | Beschreibung |
---|---|
SQLSRV_ENC_BINARY |
Die Daten werden vom Server als einfacher Bytedatenstrom zurückgegeben und weder codiert noch übersetzt. |
SQLSRV_ENC_CHAR |
Die Daten werden als 8-Bit-Zeichen gemäß der Codeseite des im System eingestellten Windows-Gebietsschemas zurückgegeben. Mehrbyte-Zeichen oder Zeichen, die dieser Codeseite nicht zugeordnet werden können, werden durch ein Einzelbyte-Zeichen, nämlich ein Fragezeichen (?), ersetzt. |
"UTF-8" |
Daten werden in UTF-8-Codierung zurückgegeben. Diese Konstante wurde in Version 1.1 des SQL Server-Treiber für PHP hinzugefügt. Weitere Informationen zur UTF-8-Unterstützung finden Sie unter Gewusst wie: Senden und Abrufen von UTF-8-Daten mit der integrierten UTF-8-Unterstützung. |
Hinweis
Bei Verwendung von SQLSRV_PHPTYPE_STREAM oder SQLSRV_PHPTYPE_STRING muss die Codierung angegeben werden. Wenn kein Parameter angegeben wird, wird ein Fehler zurückgegeben.
Weitere Informationen zu diesen Konstanten finden Sie unter Vorgehensweise: Angeben von PHP-Datentypen, Vorgehensweise: Abrufen von Zeichendaten als Stream.
SQLTYPE-Konstanten
In der folgenden Tabelle sind die Konstanten aufgeführt, mit denen SQL Server-Datentypen beschrieben werden. Einige Konstanten erfordern Parameter, die für Genauigkeit, Dezimalstellen und/oder Länge stehen. Weitere Informationen zu den SQL Server-Datentypen finden Sie unter Datentypen (Transact-SQL). Informationen zu Genauigkeit, Dezimalstellen und Länge finden Sie unter Genauigkeit, Dezimalstellen und Länge (Transact-SQL).
SQLSRV-Konstante | SQL Server-Datentyp |
---|---|
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 |
- Dies ist ein Legacytyp, der dem Typ varbinary(max) zugeordnet wird.
- Dies ist ein Legacytyp, der dem neueren Typ nvarchar zugeordnet wird.
- Dies ist ein Legacytyp, der dem neueren Typ varchar zugeordnet wird.
- Die Unterstützung für diesen Typ wurde in Version 1.1 des SQL Server-Treiber für PHP hinzugefügt.
In der folgenden Tabelle sind die SQLTYPE-Konstanten, die Parameter akzeptieren, und die für die Parameter möglichen Werte aufgeführt.
SQLTYPE | Parameter | Für Parameter zulässiger Bereich |
---|---|---|
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 - precision |
Isolationsstufenkonstanten für Transaktionen
Der TransactionIsolation-Schlüssel, der mit sqlsrv_connect verwendet wird, akzeptiert eine der folgenden Konstanten:
- SQLSRV_TXN_READ_UNCOMMITTED
- SQLSRV_TXN_READ_COMMITTED
- SQLSRV_TXN_REPEATABLE_READ
- SQLSRV_TXN_SNAPSHOT
- SQLSRV_TXN_SERIALIZABLE
Cursor- und Scrollingkonstanten
Mit den folgenden Konstanten wird die Art des Cursors angegeben, der in einem Resultset verwendet werden kann:
- SQLSRV_CURSOR_FORWARD
- SQLSRV_CURSOR_STATIC
- SQLSRV_CURSOR_DYNAMIC
- SQLSRV_CURSOR_KEYSET
Mit den folgenden Konstanten wird angegeben, welche Zeile in einem Resultset ausgewählt werden soll:
- SQLSRV_SCROLL_NEXT
- SQLSRV_SCROLL_PRIOR
- SQLSRV_SCROLL_FIRST
- SQLSRV_SCROLL_LAST
- SQLSRV_SCROLL_ABSOLUTE
- SQLSRV_SCROLL_RELATIVE
Weitere Informationen zur Verwendung dieser Konstanten finden Sie unter Angeben eines Cursortyps und Auswählen von Zeilen.