SQLSRV 상수
이 항목에서는 SQL Server Driver for PHP에 정의된 상수를 보여 줍니다.
ERR 상수
다음 표에서는 sqlsrv_errors에서 오류를 반환할지, 경고를 반환할지, 아니면 둘 다 반환할지를 지정하는 데 사용되는 상수를 나열합니다.
| 값 | 설명 |
|---|---|
SQLSRV_ERR_ALL |
마지막으로 sqlsrv 함수를 호출할 때 생성된 오류 및 경고가 반환됩니다. 이 옵션이 기본값입니다. |
SQLSRV_ERR_ALL |
마지막으로 sqlsrv 함수를 호출할 때 생성된 오류가 반환됩니다. |
SQLSRV_ERR_WARNINGS |
마지막으로 sqlsrv 함수를 호출할 때 생성된 경고가 반환됩니다. |
FETCH 상수
다음 표에서는 sqlsrv_fetch_array에서 반환된 배열 형식을 지정하는 데 사용되는 상수를 나열합니다.
| SQLSRV 상수 | 설명 |
|---|---|
SQLSRV_FETCH_ASSOC |
sqlsrv_fetch_array에서는 다음 데이터 행을 결합형 배열로 반환합니다. |
SQLSRV_FETCH_BOTH |
sqlsrv_fetch_array에서는 다음 데이터 행을 숫자 및 결합형 키가 모두 있는 배열로 반환합니다. 이 옵션이 기본값입니다. |
SQLSRV_FETCH_NUMERIC |
sqlsrv_fetch_array에서는 다음 데이터 행을 숫자로 인덱싱된 배열로 반환합니다. |
이러한 상수의 사용 방법은 방법: 데이터를 배열로 검색을 참조하십시오.
로깅 상수
이 섹션에서는 sqlsrv_configure를 사용하여 로깅 설정을 변경하는 데 사용되는 상수에 대해 설명합니다. 로깅 작업에 대한 자세한 내용은 로깅 작업을 참조하십시오.
다음 표에서는 LogSubsystems 설정 값으로 사용할 수 있는 상수를 나열합니다.
| SQLSRV 상수(괄호 안의 값은 해당 정수) | 설명 |
|---|---|
SQLSRV_LOG_SYSTEM_ALL (-1) |
모든 하위 시스템의 로깅을 설정합니다. |
SQLSRV_LOG_SYSTEM_CONN (2) |
연결 작업의 로깅을 설정합니다. |
SQLSRV_LOG_SYSTEM_INIT (1) |
초기화 작업의 로깅을 설정합니다. |
SQLSRV_LOG_SYSTEM_OFF (0) |
로깅을 해제합니다. |
SQLSRV_LOG_SYSTEM_STMT (4) |
문 작업의 로깅을 설정합니다. |
SQLSRV_LOG_SYSTEM_UTIL (8) |
오류 함수 작업(handle_error, handle_warning 등)의 로깅을 설정합니다. |
다음 표에서는 LogSeverity 설정 값으로 사용할 수 있는 상수를 나열합니다.
| SQLSRV 상수(괄호 안의 값은 해당 정수) | 설명 |
|---|---|
SQLSRV_LOG_SEVERITY_ALL (-1) |
오류, 경고 및 알림이 기록되도록 지정합니다. |
SQLSRV_LOG_SEVERITY_ERROR (1) |
오류가 기록되도록 지정합니다. |
SQLSRV_LOG_SEVERITY_NOTICE (4) |
알림이 기록되도록 지정합니다. |
SQLSRV_LOG_SEVERITY_WARNING (2) |
경고가 기록되도록 지정합니다. |
Null 허용 상수
다음 표에서는 열에 Null이 허용되는지, 아니면 이 정보를 사용할 수 없는지를 확인하는 데 사용할 수 있는 상수를 나열합니다. 열의 Null 허용 상태를 확인하기 위해 sqlsrv_field_metadata에서 반환되는 Nullable 키 값을 비교할 수 있습니다.
| SQLSRV 상수(괄호 안의 값은 해당 정수) | 설명 |
|---|---|
SQLSRV_NULLABLE_YES (0) |
이 열은 NULL을 허용합니다. |
SQLSRV_NULLABLE_NO (1) |
이 열은 NULL을 허용하지 않습니다. |
SQLSRV_NULLABLE_UNKNOWN (2) |
열에 Nulll이 허용되는지 여부를 알 수 없습니다. |
PARAM 상수
다음 목록에는 sqlsrv_query 또는 sqlsrv_prepare를 호출할 때 매개 변수 방향을 지정하는 상수가 나열되어 있습니다.
| SQLSRV 상수 | 설명 |
|---|---|
SQLSRV_PARAM_IN |
입력 매개 변수를 나타냅니다. |
SQLSRV_PARAM_INOUT |
양방향 매개 변수를 나타냅니다. |
SQLSRV_PARAM_OUT |
출력 매개 변수를 나타냅니다. |
PHPTYPE 상수
다음 표에서는 PHP 데이터 형식을 설명하는 데 사용되는 상수를 나열합니다. PHP 데이터 형식에 대한 자세한 내용은 PHP 형식(PHP Types)을 참조하십시오.
| SQLSRV 상수 | PHP 데이터 형식 |
|---|---|
SQLSRV_PHPTYPE_INT |
Integer |
SQLSRV_PHPTYPE_DATETIME |
Datetime |
SQLSRV_PHPTYPE_FLOAT |
Float |
SQLSRV_PHPTYPE_STREAM(<인코딩>1) |
Stream |
SQLSRV_PHPTYPE_STRING(<인코딩>1) |
String |
1. SQLSRV_PHPTYPE_STREAM 및 SQLSRV_PHPTYPE_STRING은 스트림 인코딩을 지정하는 매개 변수를 받아 들입니다. 다음 표에는 허용되는 매개 변수인 SQLSRV 상수와 해당 인코딩에 대한 설명이 포함되어 있습니다.
| SQLSRV 상수 | 설명 |
|---|---|
SQLSRV_ENC_BINARY |
인코딩 또는 변환을 수행하지 않고 데이터가 서버에서 원시 바이트 스트림으로 반환됩니다. |
SQLSRV_ENC_CHAR |
시스템에 설정된 Windows 로캘의 코드 페이지에 지정된 것과 같은 8비트 문자로 데이터가 반환됩니다. 이 코드 페이지에 매핑되지 않는 문자나 멀티바이트 문자는 모두 싱글바이트 물음표(?)로 대체됩니다. |
"UTF-8" |
데이터가 UTF-8 인코딩 형식으로 반환됩니다. 이 상수는 SQL Server Driver for PHP 1.1 버전에 추가되었습니다. UTF-8 지원에 대한 자세한 내용은 방법: 기본 제공 UTF-8 지원을 사용하여 UTF-8 데이터 전송 및 검색을 참조하십시오. |
참고
SQLSRV_PHPTYPE_STREAM 또는 SQLSRV_PHPTYPE_STRING을 사용할 때 인코딩을 지정해야 합니다. 매개 변수가 제공되지 않으면 오류가 반환됩니다.
이러한 상수에 대한 자세한 내용은 방법: PHP 데이터 형식 지정, 방법: 문자 데이터를 스트림으로 검색을 참조하십시오.
SQLTYPE 상수
다음 표에서는 SQL Server 데이터 형식을 설명하는 데 사용되는 상수를 나열합니다. 일부 상수에는 전체 자릿수, 소수 자릿수 및/또는 길이에 해당하는 매개 변수가 필요합니다. SQL Server 데이터 형식에 대한 자세한 내용은 데이터 형식(Transact-SQL)을 참조하십시오. 전체 자릿수, 소수 자릿수 및 길이에 대한 자세한 내용은 전체 자릿수, 소수 자릿수 및 길이(Transact-SQL)를 참조하십시오.
| SQLSRV 상수 | 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 |
- varbinary(max) 형식에 매핑되는 레거시 형식입니다.
- 새 nvarchar 형식에 매핑되는 레거시 형식입니다.
- 새 varchar 형식에 매핑되는 레거시 형식입니다.
- SQL Server Driver for PHP 1.1 버전에는 이 형식에 대한 지원이 추가되었습니다.
다음 표에서는 매개 변수 및 매개 변수에 허용되는 값 범위를 받아들이는 SQLTYPE 상수를 나열합니다.
| SQLTYPE | 매개 변수 | 매개 변수의 허용 범위 |
|---|---|---|
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 |
전체 자릿수 |
1 - 38 |
SQLSRV_SQLTYPE_DECIMAL, SQLSRV_SQLTYPE_NUMERIC |
소수 자릿수 |
1 - 전체 자릿수 |
트랜잭션 격리 수준 상수
TransactionIsolation 키는 sqlsrv_connect와 함께 사용되며 다음 상수 중 하나를 허용합니다.
- SQLSRV_TXN_READ_UNCOMMITTED
- SQLSRV_TXN_READ_COMMITTED
- SQLSRV_TXN_REPEATABLE_READ
- SQLSRV_TXN_SNAPSHOT,
- SQLSRV_TXN_SERIALIZABLE
커서 및 스크롤 상수
다음 상수는 결과 집합에서 사용할 수 있는 커서의 종류를 지정합니다.
- SQLSRV_CURSOR_FORWARD
- SQLSRV_CURSOR_STATIC
- SQLSRV_CURSOR_DYNAMIC
- SQLSRV_CURSOR_KEYSET
다음 상수는 결과 집합에서 선택할 행을 지정합니다.
- SQLSRV_SCROLL_NEXT
- SQLSRV_SCROLL_PRIOR
- SQLSRV_SCROLL_FIRST
- SQLSRV_SCROLL_LAST
- SQLSRV_SCROLL_ABSOLUTE
- SQLSRV_SCROLL_RELATIVE
이러한 상수 사용에 대한 자세한 내용은 커서 유형 지정 및 행 선택을 참조하십시오.