SQL Server Native Client에서 MARS(다중 활성 결과 집합) 사용
적용 대상: 
SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System(PDW)
Important
SNAC(SQL Server Native Client)는 다음과 함께 제공되지 않습니다.
- SQL Server 2022(16.x) 이상 버전
- SQL Server Management Studio 19 이상 버전
SQL Server Native Client(SQLNCLI 또는 SQLNCLI11)와 레거시 Microsoft OLE DB Provider for SQL Server(SQLOLEDB)는 새로운 응용 프로그램 개발에 권장되지 않습니다.
새 프로젝트의 경우 다음 드라이버 중 하나를 사용합니다.
SQL Server 데이터베이스 엔진(버전 2012부터 2019까지)의 구성 요소로 제공되는 SQLNCLI의 경우 이 수명 주기 예외 지원을 참조하세요.
SQL Server 2005(9.x)는 데이터베이스 엔진 액세스하는 애플리케이션에서 MARS(여러 활성 결과 집합)에 대한 지원을 도입했습니다. 이전 버전의 SQL Server에서는 데이터베이스 애플리케이션이 연결에서 여러 활성 문을 유지할 수 없었습니다. SQL Server 기본 결과 집합을 사용하는 경우 애플리케이션은 해당 연결에서 다른 일괄 처리를 실행하기 전에 한 일괄 처리의 모든 결과 집합을 처리하거나 취소해야 했습니다. SQL Server 2005(9.x)는 애플리케이션이 연결당 두 개 이상의 보류 중인 요청을 가질 수 있도록 하는 새로운 연결 특성을 도입했으며, 특히 연결당 둘 이상의 활성 기본 결과 집합을 포함할 수 있습니다.
MARS는 다음과 같은 새로운 기능을 사용하여 애플리케이션 디자인을 간소화합니다.
애플리케이션에서 여러 기본 결과 집합을 열어 두고 읽기를 인터리브할 수 있습니다.
애플리케이션은 기본 결과 집합이 열려 있는 동안 다른 문(예: INSERT, UPDATE, DELETE 및 저장 프로시저 호출)을 실행할 수 있습니다.
MARS를 사용하는 애플리케이션은 다음과 같은 지침이 도움이 됩니다.
기본 결과 집합은 단일 SQL 문(SELECT, OUTPUT이 있는 DML, RECEIVE, READ TEXT 등)에서 생성되는 수명이 짧거나 짧은 결과 집합에 사용해야 합니다.
서버 커서는 단일 SQL 문에 의해 생성된 수명이 길거나 큰 결과 집합에 사용해야 합니다.
결과를 반환하는지 여부에 관계없이 절차적 요청과 여러 결과를 반환하는 일괄 처리의 경우 항상 결과의 끝까지 읽습니다.
가능한 경우에는 항상 Transact-SQL 문 대신 API 호출을 사용하여 연결 속성을 변경하고 트랜잭션을 관리해야 합니다.
MARS에서 동시 일괄 처리가 실행되는 동안에는 세션 범위의 가장이 금지됩니다.
참고 항목
기본적으로 MARS 기능은 드라이버에서 사용하도록 설정되지 않습니다. SQL Server Native Client를 사용하여 SQL Server에 연결할 때 MARS를 사용하려면 연결 문자열 내에서 MARS를 특별히 사용하도록 설정해야 합니다. 그러나 애플리케이션이 드라이버가 MARS를 지원하는 것을 감지하는 경우 일부 애플리케이션은 기본적으로 MARS를 사용하도록 설정할 수 있습니다. 이러한 애플리케이션의 경우 필요에 따라 연결 문자열 MARS를 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 이 항목의 뒷부분에 나오는 SQL Server Native Client OLE DB 공급자 및 SQL Server Native Client ODBC 드라이버 섹션을 참조하세요.
SQL Server Native Client는 연결에 대한 활성 문의 수를 제한하지 않습니다.
단일 다중 문 일괄 처리 또는 저장 프로시저를 동시에 실행할 필요가 없는 일반적인 애플리케이션은 MARS가 구현되는 방식을 이해할 필요 없이 MARS의 이점을 누릴 수 있습니다. 그러나 더 복잡한 요구 사항이 있는 애플리케이션은 이를 고려해야 합니다.
MARS를 사용하면 단일 연결 내에서 여러 요청의 실행을 인터리브할 수 있습니다. 즉, 일괄 처리를 실행할 수 있으며 실행 내에서 다른 요청을 실행할 수 있습니다. 하지만 MARS는 병렬 실행이 아니라 인터리브로 정의된다는 것에 주의하십시오.
MARS 인프라를 사용하면 여러 배치를 인터리브 방식으로 실행할 수 있지만 실행은 잘 정의된 지점에서만 전환할 수 있습니다. 또한 대부분의 문은 일괄 처리 내에서 개별적으로 실행되어야 합니다. 행을 클라이언트에 반환하는 문(경우에 따라 수율 지점이라고도 함)은 행을 클라이언트로 보내는 동안 완료되기 전에 실행을 인터리브할 수 있습니다. 예를 들면 다음과 같습니다.
SELECT
FETCH
RECEIVE
저장 프로시저 또는 일괄 처리의 일부로 실행되는 다른 문은 실행을 다른 MARS 요청으로 전환하기 전에 완료까지 실행해야 합니다.
일괄 처리에서 실행이 인터리브되는 세부적인 방식은 많은 요소의 영향을 받게 되므로 양보점을 포함하는 다중 일괄 처리에서 명령이 실행되는 정확한 순서를 예측하기 어렵습니다. 따라서 이와 같은 복잡한 일괄 처리의 인터리브 실행 때문에 원하지 않는 결과가 나타나지 않도록 주의하십시오.
연결 상태(SET, USE) 및 트랜잭션(BEGIN TRAN, COMMIT, ROLLBACK)을 관리하는 Transact-SQL 문 대신 API 호출을 사용하여 양보점을 포함할 수 있는 다중 문 일괄 처리에 이러한 문이 포함되지 않도록 하고 모든 결과를 사용하거나 취소하여 이러한 일괄 처리의 실행을 직렬화함으로써 문제를 방지합니다.
참고 항목
MARS를 사용할 때 수동 또는 암시적 트랜잭션을 시작하는 일괄 처리 또는 저장 프로시저는 일괄 처리가 종료되기 전에 트랜잭션을 완료해야 합니다. 그렇지 않은 경우 SQL Server는 일괄 처리가 완료되면 트랜잭션에 의해 변경된 모든 변경 내용을 롤백합니다. 이러한 트랜잭션은 SQL Server에서 일괄 처리 범위 트랜잭션으로 관리됩니다. MARS를 사용할 때 기존 잘 동작하는 저장 프로시저를 사용할 수 있도록 SQL Server 2005(9.x)에 도입된 새로운 유형의 트랜잭션입니다. 일괄 처리 범위의 트랜잭션에 대한 자세한 내용은 트랜잭션 문(Transact-SQL)을 참조하세요.
ADO에서 MARS를 사용하는 예제는 SQL Server Native Client에서 ADO 사용을 참조 하세요.
메모리 내 OLTP
메모리 내 OLTP는 쿼리 및 고유하게 컴파일된 저장 프로시저를 사용하여 MARS를 지원합니다. MARS를 사용하면 새 결과 집합에서 행을 가져오는 요청을 보내기 전에 각 결과 집합을 완전히 검색할 필요 없이 여러 쿼리에서 데이터를 요청할 수 있습니다. 열려 있는 여러 결과 집합에서 성공적으로 읽으려면 MARS 사용 연결을 사용해야 합니다.
MARS는 기본적으로 사용하지 않도록 설정되므로 연결 문자열 추가하여 MultipleActiveResultSets=True 명시적으로 사용하도록 설정해야 합니다. 다음 예제에서는 SQL Server 인스턴스에 연결하고 MARS를 사용하도록 지정하는 방법을 보여 줍니다.
Data Source=MSSQL; Initial Catalog=AdventureWorks; Integrated Security=SSPI; MultipleActiveResultSets=True
메모리 내 OLTP가 있는 MARS는 SQL 엔진의 나머지 부분의 MARS와 기본적으로 동일합니다. 다음은 메모리 최적화 테이블 및 고유하게 컴파일된 저장 프로시저에서 MARS를 사용하는 경우의 차이점을 보여 줍니다.
MARS 및 메모리 최적화 테이블
MARS 지원 연결을 사용하는 경우 디스크 기반 테이블과 메모리 최적화 테이블 간의 차이점은 다음과 같습니다.
두 문은 동일한 대상 개체의 데이터를 수정할 수 있지만 둘 다 동일한 레코드를 수정하려고 하면 쓰기-쓰기 충돌이 발생하면 새 작업이 실패합니다. 그러나 두 작업이 서로 다른 레코드를 수정하면 작업이 성공합니다.
각 문은 SNAPSHOT 격리에서 실행되므로 새 작업에서 기존 문의 변경 내용을 볼 수 없습니다. 동시 문이 동일한 트랜잭션에서 실행되는 경우에도 SQL 엔진은 서로 격리된 각 문에 대해 일괄 처리 범위의 트랜잭션을 만듭니다. 그러나 일괄 처리 범위의 트랜잭션은 여전히 함께 바인딩되어 있으므로 일괄 처리 범위의 트랜잭션 중 하나의 롤백이 동일한 일괄 처리의 다른 트랜잭션에 영향을 줍니다.
DDL 작업은 사용자 트랜잭션에서 허용되지 않으므로 즉시 실패합니다.
MARS 및 고유하게 컴파일된 저장 프로시저
고유하게 컴파일된 저장 프로시저는 MARS 지원 연결에서 실행할 수 있으며 양보점이 발생할 때만 다른 문으로 실행을 양보할 수 있습니다. 수익률 지점에는 다른 문으로 실행을 생성할 수 있는 고유하게 컴파일된 저장 프로시저 내의 유일한 문인 SELECT 문이 필요합니다. SELECT 문이 프로시저에 없을 경우 문은 일시 중단되지 않으며 다른 문이 시작되기 전에 완료까지 실행됩니다.
MARS 및 메모리 내 OLTP 트랜잭션
인터리브되는 문 및 원자성 블록에 의해 변경된 내용은 서로 격리됩니다. 예를 들어 한 문 또는 원자성 블록이 일부 변경한 다음 다른 문으로 실행을 생성하는 경우 새 문은 첫 번째 문에서 변경한 내용을 볼 수 없습니다. 또한 첫 번째 문이 실행을 다시 시작하면 다른 문에서 변경한 내용을 볼 수 없습니다. 문은 문이 시작되기 전에 완료되고 커밋된 변경 내용만 볼 수 있습니다.
BEGIN TRANSACTION 문을 사용하여 현재 사용자 트랜잭션 내에서 새 사용자 트랜잭션을 시작할 수 있습니다. 이는 interop 모드에서만 지원되므로 BEGIN TRANSACTION은 고유하게 컴파일된 저장 프로시저 내에서가 아니라 T-SQL 문에서만 호출할 수 있습니다. SAVE TRANSACTION 또는 트랜잭션에 대한 API 호출을 사용하여 트랜잭션에 저장 지점을 만들 수 있습니다. 저장(save_point_name)을 저장점으로 롤백합니다. 이 기능은 T-SQL 문에서만 사용할 수 있으며 고유하게 컴파일된 저장 프로시저에서는 사용할 수 없습니다.
MARS 및 columnstore 인덱스
SQL Server(2016부터)는 columnstore 인덱스가 있는 MARS를 지원합니다. SQL Server 2014는 MARS를 사용하여 columnstore 인덱스가 있는 테이블에 대한 읽기 전용 연결을 합니다. 그러나 SQL Server 2014는 columnstore 인덱스가 있는 테이블에서 DML(동시 데이터 조작 언어) 작업에 MARS를 지원하지 않습니다. 이 경우 SQL Server는 연결을 종료하고 트랜잭션을 중단합니다. SQL Server 2012에는 읽기 전용 columnstore 인덱스가 있으며 MARS는 해당 인덱스에 적용되지 않습니다.
SQL Server Native Client OLE DB 공급자
SQL Server Native Client OLE DB 공급자는 DBPROPSET_SQLSERVERDBINIT 속성 집합에서 구현되는 SSPROP_INIT_MARSCONNECTION 데이터 원본 초기화 속성을 추가하여 MARS를 지원합니다. 또한 새로운 연결 문자열 키워드인 MarsConn이 추가되었습니다. true 또는 false 값을 허용합니다.false가 기본값입니다.
데이터 원본 속성 DBPROP_MULTIPLECONNECTIONS 기본값은 VARIANT_TRUE. 이것은 공급자가 다중 동시 명령 및 행 집합 개체를 지원하기 위해 다중 연결을 생성한다는 의미입니다. MARS를 사용하는 경우 SQL Server Native Client는 단일 연결에서 여러 명령 및 행 집합 개체를 지원할 수 있으므로 기본적으로 MULTIPLE_CONNECTIONS VARIANT_FALSE 설정됩니다.
DBPROPSET_SQLSERVERDBINIT 속성 집합의 향상된 기능과 대한 자세한 내용은 초기화 및 권한 부여 속성을 참조 하세요.
SQL Server Native Client OLE DB 공급자 예제
이 예제에서는 SQL Server 네이티브 OLE DB 공급자를 사용하여 데이터 원본 개체를 만들고 MARS는 세션 개체를 만들기 전에 설정된 DBPROPSET_SQLSERVERDBINIT 속성을 사용하여 사용하도록 설정됩니다.
#include <sqlncli.h>
IDBInitialize *pIDBInitialize = NULL;
IDBCreateSession *pIDBCreateSession = NULL;
IDBProperties *pIDBProperties = NULL;
// Create the data source object.
hr = CoCreateInstance(CLSID_SQLNCLI10, NULL,
CLSCTX_INPROC_SERVER,
IID_IDBInitialize,
(void**)&pIDBInitialize);
hr = pIDBInitialize->QueryInterface(IID_IDBProperties, (void**)&pIDBProperties);
// Set the MARS property.
DBPROP rgPropMARS;
// The following is necessary since MARS is off by default.
rgPropMARS.dwPropertyID = SSPROP_INIT_MARSCONNECTION;
rgPropMARS.dwOptions = DBPROPOPTIONS_REQUIRED;
rgPropMARS.dwStatus = DBPROPSTATUS_OK;
rgPropMARS.colid = DB_NULLID;
V_VT(&(rgPropMARS.vValue)) = VT_BOOL;
V_BOOL(&(rgPropMARS.vValue)) = VARIANT_TRUE;
// Create the structure containing the properties.
DBPROPSET PropSet;
PropSet.rgProperties = &rgPropMARS;
PropSet.cProperties = 1;
PropSet.guidPropertySet = DBPROPSET_SQLSERVERDBINIT;
// Get an IDBProperties pointer and set the initialization properties.
pIDBProperties->SetProperties(1, &PropSet);
pIDBProperties->Release();
// Initialize the data source object.
hr = pIDBInitialize->Initialize();
//Create a session object from a data source object.
IOpenRowset * pIOpenRowset = NULL;
hr = IDBInitialize->QueryInterface(IID_IDBCreateSession, (void**)&pIDBCreateSession));
hr = pIDBCreateSession->CreateSession(
NULL, // pUnkOuter
IID_IOpenRowset, // riid
&pIOpenRowset )); // ppSession
// Create a rowset with a firehose mode cursor.
IRowset *pIRowset = NULL;
DBPROP rgRowsetProperties[2];
// To get a firehose mode cursor request a
// forward only read only rowset.
rgRowsetProperties[0].dwPropertyID = DBPROP_IRowsetLocate;
rgRowsetProperties[0].dwOptions = DBPROPOPTIONS_REQUIRED;
rgRowsetProperties[0].dwStatus = DBPROPSTATUS_OK;
rgRowsetProperties[0].colid = DB_NULLID;
VariantInit(&(rgRowsetProperties[0].vValue));
rgRowsetProperties[0].vValue.vt = VARIANT_BOOL;
rgRowsetProperties[0].vValue.boolVal = VARIANT_FALSE;
rgRowsetProperties[1].dwPropertyID = DBPROP_IRowsetChange;
rgRowsetProperties[1].dwOptions = DBPROPOPTIONS_REQUIRED;
rgRowsetProperties[1].dwStatus = DBPROPSTATUS_OK;
rgRowsetProperties[1].colid = DB_NULLID;
VariantInit(&(rgRowsetProperties[1].vValue));
rgRowsetProperties[1].vValue.vt = VARIANT_BOOL;
rgRowsetProperties[1].vValue.boolVal = VARIANT_FALSE;
DBPROPSET rgRowsetPropSet[1];
rgRowsetPropSet[0].rgProperties = rgRowsetProperties
rgRowsetPropSet[0].cProperties = 2
rgRowsetPropSet[0].guidPropertySet = DBPROPSET_ROWSET;
hr = pIOpenRowset->OpenRowset (NULL,
&TableID,
NULL,
IID_IRowset,
1,
rgRowsetPropSet
(IUnknown**)&pIRowset);
SQL Server Native Client ODBC 드라이버
SQL Server Native Client ODBC 드라이버는 SQLSetConnectAttr 및 SQLGetConnectAttr 함수를 추가하여 MARS를 지원합니다. SQL_MARS_ENABLED_NO 기본값인 SQL_MARS_ENABLED_YES 또는 SQL_MARS_ENABLED_NO 허용하도록 SQL_COPT_SS_MARS_ENABLED 추가되었습니다. 또한 추가된 새 연결 문자열 키워드인 Mars_Connection. "yes" 또는 "no" 값을 허용합니다. "no"가 기본값입니다.
SQL Server Native Client ODBC 드라이버 예제
이 예제에서는 SQLDriverConnect 함수를 호출하여 데이터베이스를 연결하기 전에 MARS를 사용하도록 설정하는 데 SQLSetConnectAttr 함수를 사용합니다. 연결이 완료되면 두 개의 SQLExecDirect 함수가 호출되어 동일한 연결에 두 개의 별도 결과 집합을 만듭니다.
#include <sqlncli.h>
SQLSetConnectAttr(hdbc, SQL_COPT_SS_MARS_ENABLED, SQL_MARS_ENABLED_YES, SQL_IS_UINTEGER);
SQLDriverConnect(hdbc, hwnd,
"DRIVER=SQL Server Native Client 10.0;
SERVER=(local);trusted_connection=yes;", SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt1);
SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt2);
// The 2nd execute would have failed with connection busy error if
// MARS were not enabled.
SQLExecDirect(hstmt1, L"SELECT * FROM Authors", SQL_NTS);
SQLExecDirect(hstmt2, L"SELECT * FROM Titles", SQL_NTS);
// Result set processing can interleave.
SQLFetch(hstmt1);
SQLFetch(hstmt2);