연결 문자열 속성

  • 아티클

적용 대상: SQL Server Analysis Services Azure Analysis Services 패브릭/Power BI Premium

이 문서에서는 Azure Analysis Services(Azure AS), SQL Server Analysis Services(SSAS) 및 Power BI Premium 의미 체계 모델에 연결하고 쿼리하는 클라이언트 애플리케이션에서 사용하는 연결 문자열 속성에 대해 설명합니다. 이러한 속성은 Analysis Services용 Analysis Services 클라이언트 라이브러리, ADOMD.NET, AMO 및 OLE DB(MSOLAP) 공급자에서 사용됩니다. 대부분의 연결 문자열 속성은 세 클라이언트 라이브러리 모두에 사용할 수 있습니다. 예외는 설명에 명시되어 있습니다.

왼쪽 목차 위의 버전 선택기를 사용하여 특정 플랫폼 또는 버전에 적용되는 속성만 볼 수 있습니다.

연결 속성

데이터 원본

서버 인스턴스를 지정합니다. 이 속성은 모든 연결에 필요합니다.

Azure Analysis Services 유효한 값에는 <protocol>://<region>/<servername> 프로토콜이 문자열 asazure 이거나 link서버 이름 별칭을 사용하는 경우 지역이 서버가 만들어진 Uri(예: westus.asazure.windows.net)이 포함되며, servername은 지역 내의 고유 서버 이름입니다.

예제 Description
Data source=asazure://westus.asazure.windows.net/myasserver Azure Analysis Services.
Data source=link://friendlyname.salesapp.azurewebsites.net/ 서버 이름 별칭을 사용하여 Azure Analysis Services.

Power BI Premium 유효한 값에는 <protocol>://api.powerbi.com/v1.0/[tenant name]/[workspace name] 프로토콜이 문자열powerbi이고, Uri는 api.powerbi.com이고, 테넌트 이름은 organization 테넌트 이름 또는 myorg이고, 작업 영역 이름은 전용 용량에 할당된 작업 영역의 이름입니다.

예제 Description
Data source=powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace 작업 영역을 Power BI Premium.

SQL Server Analysis Services 유효한 값에는 서버의 네트워크 이름 또는 IP 주소, 로컬 연결의 로컬 또는 localhost, 서버가 HTTP 또는 HTTPS 액세스를 위해 구성된 경우 URL 또는 로컬 큐브(.cub) 파일의 이름이 포함됩니다.

예제 Description
Data source=AW-SRV01 SSAS 기본 instance 및 포트(TCP 2383).
Data source=AW-SRV01\Finance 이름이 instance SSAS입니다.
Data source=AW-SRV01:8081 SSAS 기본 instance 지정된 포트입니다.
Data source=AW-SRV01.corp.Adventure-Works.com SSAS 정규화된 도메인 이름, 기본 instance 및 포트입니다.
Data source=172.16.254.1 DNS 서버 조회를 바이패스하는 서버의 SSAS IP 주소입니다. 연결 문제 해결에 유용합니다.
공급자

이 속성은 MSOLAP와 같은 OLE DB 공급자를 사용하는 경우 연결 문자열 필요합니다. "Provider=MSOLAP"와 같은 버전 독립적 공급자(일반적으로 최신)를 사용하거나 "Provider=MSOLAP.7"과 같은 버전 종속 공급자를 지정할 수도 있습니다. 유효한 버전 종속 값은 MSOLAP 패턴을 따릅니다.<버전이 <7 또는 8인 버전>>입니다. 예를 들어 MSOLAP.7은 SQL Server 2016년에 릴리스되었습니다. 버전 ".8"은 최신 버전이며 "evergreen"으로 간주됩니다. 이전 버전과의 호환성이 유지되는 상태로 계속 업데이트될 것으로 예상됩니다. 이전 버전 번호도 가능하지만 MSOLAP 릴리스는 이제 표준 지원에서 벗어났습니다.

이 속성은 ADOMD.NET 및 AMO에 대한 선택 사항입니다. MSOLAP 연결 문자열 복사하여 ADOMD.NET 및 AMO와 함께 사용할 때 편의를 위해 사용할 수 있습니다.

예제 Description
Provider=MSOLAP.7 Connections Analysis Services용 OLE DB 공급자의 SQL Server 2016 버전이 필요한 경우
큐브

큐브 이름 또는 큐브 뷰 이름입니다. 데이터베이스에는 여러 개의 큐브와 큐브 뷰가 포함될 수 있습니다. 여러 대상이 가능한 경우 연결 문자열에 큐브 또는 큐브 뷰 이름을 포함하십시오.

예제 Description
Cube=Sales Sales라는 큐브입니다.
Cube=SalesPerspective SalesPerspective라는 큐브 뷰입니다.

인증 및 보안 속성

Azure Analysis Services 및 Power BI Premium Microsoft Entra ID 사용 - MFA를 사용하는 유니버설(권장), 사용자 이름 및 암호를 사용한 인증 Microsoft Entra, Microsoft Entra 액세스 토큰 또는 Windows 인증.

SQL Server Analysis Services Windows 인증만 사용합니다. IIS 8.0에서 Analysis Services에 대한 HTTP 액세스 구성 문서에 설명된 대로 MSMDPUMP.dll 통해 HTTP 액세스를 사용하도록 설정한 경우 기본 인증 및 익명 인증을 사용할 수 있습니다. HTTP를 통해 Analysis Services에 지원되는 인증 방법을 구성하는 방법에 대한 자세한 내용은 3단계: IIS 인증 구성 을 참조하세요.

속성은 사전순으로 나열됩니다.

EffectiveUserName

서버에서 사용자 ID를 가장해야 하는 경우 를 사용합니다. SSAS의 경우 domain\user 형식으로 를 지정합니다. Azure AS 및 Power BI Premium UPN 형식으로 지정합니다. 이 속성을 사용하려면 호출자가 Analysis Services에서 관리 권한을 갖고 있어야 합니다. Power BI Premium 호출자는 의미 체계 모델이 있는 작업 영역 관리자여야 합니다.

CustomData

연결 문자열 엔진에 전달된 다음 CustomData() MDX 함수 또는 CUSTOMDATA() DAX 함수를 사용하여 검색할 문자열 값입니다. userID 또는 username을 값으로 전달한 다음 보안 식 정의에 해당 값을 지정하는 데 가장 일반적으로 사용됩니다.

암호 암호화

로컬 암호가 로컬 큐브를 암호화하는 데 사용될지 여부를 지정합니다. 유효한 값은 True 또는 False입니다. 기본값은 False입니다.

암호화 암호

암호화된 로컬 큐브를 해독하는 데 사용되는 암호입니다. 기본값은 비어 있습니다. 이 값은 사용자가 명시적으로 설정해야 합니다.

가장 수준

클라이언트를 가장할 때 서버에서 사용할 수 있는 가장 수준을 나타냅니다. 유효한 값은 다음과 같습니다.

  • 익명. 클라이언트가 서버에 대해 익명입니다. 서버 프로세스는 클라이언트에 대한 정보를 가져올 수 없으며 클라이언트를 가장할 수도 없습니다.
  • 식별합니다. 서버 프로세스가 클라이언트 ID를 가져올 수 있습니다. 서버는 권한 부여를 위해 클라이언트 ID를 가장할 수 있지만 클라이언트로 시스템 개체에 액세스할 수 없습니다.
  • 가장합니다. 이것은 기본값입니다. 클라이언트 ID를 가장할 수 있지만 연결이 설정된 경우에만 가능하며 일부 호출에서는 가장할 수 없습니다.
  • 대리자입니다. 서버 프로세스가 클라이언트를 대신해 동작하는 동안 클라이언트 보안 컨텍스트를 가장할 수 있습니다. 서버 프로세스는 또한 클라이언트를 대신해 동작하는 동안 다른 서버로 보내는 호출을 만들 수 있습니다.
Integrated Security

호출자의 Windows ID는 Analysis Services에 연결하는 데 사용됩니다. 유효한 값은 SSPI, blank, Basic 및 ClaimsToken*입니다.

SSPI는 NTLM, Kerberos 또는 익명 인증을 허용하는 TCP 연결의 기본값입니다. Azure AS 및 Power BI Premium SSPI는 AD 번역을 나타냅니다. SSPI를 사용하는 경우 ProtectionLevel 속성을 Connect, Pkt Integrity 또는 Pkt Privacy로 설정해야 합니다.

blank는 HTTP 연결의 기본값입니다.

*ClaimsToken은 Azure AS 및 Power BI Premium 지원됩니다.

보안 정보 유지

유효한 값은 True 또는 False입니다. True로 설정되면 연결이 설정된 후 연결 문자열에서 이전에 지정된 사용자 ID 또는 암호와 같은 보안 정보를 연결에서 가져올 수 있습니다. 기본값은 False입니다.

보호 수준

연결에서 사용되는 보안 수준을 결정합니다. 지원되는 값은 기본 전송에 따라 달라집니다. 유효한 값은 다음과 같습니다.

  • 없음. 인증되지 않은 연결이나 익명 연결입니다. 서버에 전송되는 데이터에 대한 인증을 수행하지 않습니다.
  • 연결합니다. 인증된 연결입니다. 클라이언트가 서버와 관계를 설정하는 경우에만 인증합니다.
  • Pkt Integrity. 암호화된 연결입니다. 모든 데이터가 클라이언트에서 수신되고 전송 중에 변경되지 않았는지 확인합니다.
  • Pkt Privacy. 서명된 암호화- TCP에 대해서만 지원됩니다. 모든 데이터가 클라이언트로부터 수신되고 전송 중에 변경되지 않았는지 확인하고 암호화하여 데이터의 개인 정보를 보호합니다.

자세한 내용은 ADOMD.NET 보안 Connections 수립을 참조하세요.

역할

해당 역할이 제공하는 사용 권한을 사용하여 서버 또는 데이터베이스에 연결할 미리 정의된 역할의 쉼표로 구분된 목록을 지정합니다. 이 속성을 생략하면 모든 역할이 사용되고 유효 사용 권한은 모든 역할의 조합이 됩니다. 예를 들어 Roles=' ' 속성을 빈 값으로 설정하면 클라이언트 연결에 역할 멤버 자격이 없음을 의미합니다.

이 속성을 사용하는 관리자는 역할이 제공하는 사용 권한을 사용하여 연결됩니다. 역할이 충분한 권한을 제공하지 않으면 일부 명령이 실패할 수 있습니다.

Power BI Premium 작업 영역에 연결할 때 역할을 지정하는 경우 Power BI 보안 모델의 작업 영역 역할을 사용합니다.

SSPI

Integrated Security 가 SSPI로 설정된 경우 클라이언트 인증에 사용할 보안 패키지를 명시적으로 지정합니다. SSPI는 여러 패키지를 지원하지만 이 속성을 사용하여 특정 패키지를 지정할 수 있습니다. 유효한 값은 다음과 같습니다.

  • Negotiate
  • Kerberos
  • NTLM
  • 익명 사용자

이 속성이 설정되지 않은 경우 모든 패키지를 연결에 사용할 수 있습니다.

데이터에 대해 암호화 사용

데이터 전송을 암호화합니다. 유효한 값은 True 또는 False입니다.

사용자 ID=...; Password=

클라이언트 애플리케이션의 현재 활성 사용자를 서버에 자동으로 전파할 수 없는 경우 사용자 ID 및 암호 속성은 서버에 적절한 자격 증명을 제공합니다. 동작은 전송 프로토콜 및 연결된 서버에 따라 달라집니다.

  • TCP를 통해 SSAS에 연결할 때 클라이언트 라이브러리는 지정된 사용자 이름 및 암호를 사용하여 Windows 사용자를 가장한 다음, 평소와 같이 서버에 연결합니다.

  • HTTP(S)를 통해 SSAS에 연결할 때 자격 증명은 웹 서버에 구성된 인증 모드(예: 기본 인증 또는 Windows 인증)에 따라 웹 서버에 제공됩니다. 웹 서버는 SSAS 서버에 연결하기 전에 적절한 Windows 가장을 수행하므로 서버에 올바른 자격 증명 흐름을 제공합니다.

  • Azure AS 또는 Power BI Premium 연결할 때 사용자 ID 및 암호는 인증 중에 서비스에 표시되는 Microsoft Entra 토큰을 가져오는 데 사용됩니다. Microsoft Entra ID 토큰을 생성하기 전에 추가 사용자 상호 작용이 필요할 수 있는 MFA(다단계 인증)도 필요할 수 있습니다.

  • 사용자 고유의 애플리케이션에서 유효한 Microsoft Entra ID 전달자 액세스 토큰을 이미 획득한 경우 연결을 설정하기 전에 AdomdConnection 개체의 AccessToken 속성을 설정할 수 있습니다. 관련 연결 개체(AdomdConnection, Server 등)의 AccessToken 속성에서 액세스 토큰을 설정하고 만료 시간을 지정해야 합니다. 인증은 사용자에 대해 대화형으로 획득한 전달자 토큰과 OAuth 2.0 On-Behalf-Of 흐름을 사용하여 지원됩니다(예: 사용자를 대신하여 Analysis Services에 연결하는 중간 계층 웹 애플리케이션). AccessToken 속성에서 액세스 토큰을 전달할 때 토큰 형식을 생략합니다. Analysis Services 클라이언트 라이브러리는 액세스 토큰에 인증 체계 값 "Bearer" 를 자동으로 추가합니다. 다음 사항에 유의해야 합니다.

    • Microsoft Entra 전달자 액세스 토큰의 수명은 제한됩니다. 기본적으로 60~90분 사이입니다. 애플리케이션이 액세스 토큰 수명을 초과하는 장기 실행 작업을 수행하는 경우 AdomdConnection 개체의 OnAccessTokenExpired 속성을 통해 콜백 함수를 제공하여 현재 액세스 토큰이 만료될 때 액세스 토큰을 새로 고칠 수 있습니다. 또는 콜백 함수의 도움 없이 AccessToken 속성을 직접 업데이트할 수 있습니다. 현재 액세스 토큰의 수명 내에서 액세스 토큰이 새로 고쳐지도록 콜백 함수를 사용하는 것이 좋습니다.
    • 암호 연결 문자열 속성을 사용하여 액세스 토큰을 전달하는 것은 권장되지 않습니다. 여전히 연결 문자열 사용자 ID 속성을 생략하고 Password 속성에서 액세스 토큰만 지정할 수 있지만 이러한 경우 액세스 토큰을 새로 고칠 수 없습니다. 필요한 경우 기존 연결에 대한 새 액세스 토큰을 제공할 수 있도록 AccessToken 속성을 대신 사용합니다. Password 속성과 AccessToken 속성을 둘 다 설정하는 것은 지원되지 않습니다.

참고: "사용자 ID"에 포함된 공간이 있습니다. 사용자 ID에 대한 대체 별칭은 UID 이고 암호의 대체 별칭은 PWD입니다.

특수 용도 속성

이러한 속성은 애플리케이션에 필요한 특정 연결 동작을 보장하는 데 사용됩니다. 속성은 사전순으로 나열됩니다.

애플리케이션 이름

연결과 관련된 애플리케이션의 이름을 설정합니다. 이 값은 추적 이벤트를 모니터링할 때 유용할 수 있으며 특히 동일한 데이터베이스에 액세스하는 여러 애플리케이션이 있는 경우에 유용합니다. 예를 들어 application Name='test'를 연결 문자열 추가하면 'test'가 SQL Server Profiler 추적에 표시됩니다. 이 속성의 별칭에는 SspropInitAppName, AppName이 포함됩니다. 자세한 내용은 SQL Server Connections 애플리케이션 이름을 참조하세요.

자동 동기화 기간

클라이언트 및 서버 캐시 동기화의 빈도(밀리초)를 설정합니다. ADOMD.NET은 최소 메모리 오버헤드가 있는 자주 사용되는 개체에 대한 클라이언트 캐싱을 제공합니다. 이는 서버와의 왕복 횟수를 줄이는 데 도움이 됩니다. 기본값은 10,000밀리초(또는 10초)입니다. null 또는 0으로 설정되면 자동 동기화가 해제됩니다.

성능상의 이유로 클라이언트 라이브러리는 서버의 일부 정보(예: 특정 스키마 행 집합)를 캐시합니다. 자동 동기화 기간을 사용하면 클라이언트 라이브러리가 캐시를 비워야 하는지 여부를 서버와 확인하는 기간을 변경할 수 있습니다. 일반적으로 값을 기본값에서 변경할 필요가 없습니다.

문자 인코딩

문자가 요청에 대해 인코딩되는 방법을 정의합니다. 유효한 값은 Default 또는 UTF-8 (동일한 값) 및 UTF-16입니다.

CommitTimeout

XMLA 속성입니다. 롤백하기 전에 현재 실행 중인 명령의 커밋 단계에서 대기하는 시간(밀리초)을 결정합니다. 0보다 큰 경우 서버 구성에서 해당 CommitTimeout 속성의 값을 무시합니다.

CompareCaseSensitiveStringFlags

지정한 로캘에 대한 대/소문자를 구분하는 문자열 비교를 조정합니다.

압축 수준

TransportCompression이 압축된 경우 압축 수준을 설정하여 사용되는 압축의 양을 제어할 수 있습니다. 유효한 값은 0 부터 9까지이며, 0은 최소 압축이 있고 9는 가장 압축됩니다. 압축이 증가하면 성능이 저하됩니다. 기본값은 0입니다.

연결 제한 시간

클라이언트가 시간 초과 전에 연결을 시도하는 최대 시간(초)을 결정합니다. 이 기간 내에 연결이 성공하지 못하면 클라이언트는 연결 시도를 종료하고 오류를 생성합니다.

DbpropMsmdRequestMemoryLimit

연결에 대한 Memory\QueryMemoryLimit 서버 속성 값을 재정의합니다.

킬로바이트 단위로 지정된 이 속성은 QueryMemoryLimit에서 허용되는 최대 메모리(백분율로 지정됨)에서 쿼리 중에 사용되는 메모리 양을 줄일 수 있습니다. QueryMemoryLimit에 지정된 최대 허용 메모리를 초과하여 사용되는 메모리 양을 늘릴 수 없습니다.

기본 MDX 시각적 모드

차원 보안이 적용될 때 멤버가 집계되는 방법을 제어하려면 이 속성을 설정합니다.

모든 사용자가 볼 수 있는 큐브 데이터의 경우 값 합계에 포함된 모든 값이 표시되기 때문에 모든 멤버를 집계하는 것이 합리적입니다. 그러나 사용자 ID를 기준으로 차원을 필터링하거나 제한하는 경우 모든 멤버에 대한 값 합계를 표시하면(제한된 값과 허용된 값을 단일한 값 합계로 결합하면) 혼란을 주거나 공개되어야 하는 것보다 많은 정보를 표시할 수도 있습니다.

차원 보안이 적용될 때 멤버가 집계되는 방법을 지정하려는 경우 허용되는 값만 집계에서 사용하려면 이 속성을 True로 설정하고 제한된 값을 값 합계에서 제외하려면 False로 설정합니다.

연결 문자열에서 설정될 때 이 값은 큐브 또는 큐브 뷰 수준에 적용됩니다. 모델 내에서는 보다 세부적인 수준에서 보이는 값 합계를 제어할 수 있습니다.

유효한 값은 다음과 같습니다.

  • 0 이 기본값입니다. 현재 기본 동작은 사용자에게서 숨겨진 값이 집계에 포함되는 2입니다.
  • 1 은 숨겨진 값을 합계에서 제외합니다. Excel의 경우 이 값이 기본값입니다.
  • 2 에는 합계에 숨겨진 값이 포함됩니다. 이 값은 서버에서 기본값입니다.

이 속성의 별칭은 VisualMode입니다.

MDX 호환성

이 속성의 용도는 MDX 쿼리를 발행하는 애플리케이션에 대해 일관성 있는 MDX 동작의 집합을 보장하는 것입니다. MDX 쿼리를 사용하여 Analysis Services에 연결된 피벗 테이블을 채우고 계산하는 Excel에서는 이 속성을 1로 설정하여 비정형 계층의 자리 표시자 멤버가 피벗 테이블에 표시되도록 합니다. 유효한 값에는 0, 1, 2이 포함됩니다.

0과 1은 자리 표시자 멤버를 노출하고 2는 노출하지 않습니다. 비어 있으면 0으로 간주됩니다.

MDX 누락 멤버 모드

MDX 문에서 누락된 멤버를 무시할 것인지 여부를 나타냅니다. 유효한 값은 Default, Error 및 Ignore입니다. Default는 서버에서 정의된 값을 사용합니다. 멤버가 없을 때 오류가 발생합니다. Ignore는 누락된 값이 무시되도록 지정합니다.

응답 최적화

다음 쿼리 응답 최적화 중 어느 것을 사용할 수 있는지를 나타내는 비트 마스크입니다.

  • 0x01 NormalTupleSet(기본값)을 사용합니다.
  • 0x02 슬라이서가 비어 있는 경우 사용합니다.
패킷 크기

TCP 연결에만 적용됩니다. 512에서 32,767까지의 네트워크 패킷 크기(바이트)입니다. 기본 네트워크 패킷 크기는 4096입니다.

프로토콜 형식

XMLA 통신 프로토콜에서 사용하는 XML의 형식을 설정합니다. 유효한 값은 Default, XML 또는 Binary입니다. 이진 형식 또는 텍스트 XML로 보낼 XML을 지정할 수 있습니다. 이진 형식은 XML 요소 및 특성을 인코딩하여 더 작게 만듭니다. 또한 전송 압축 옵션을 사용하여 요청 및 응답의 크기를 줄이기 위해 메시지에 압축을 사용하도록 설정할 수도 있습니다. 요청 및 응답은 클라이언트와 서버에서 지원하는 항목에 따라 다른 프로토콜 형식을 사용할 수 있습니다. 예를 들어 클라이언트 라이브러리는 응답에 대해서만 이진을 지원할 수 있지만 요청에 대해서는 지원하지 않거나 서버가 들어오는 요청에 대해 이진 파일을 사용하지 않도록 설정했을 수 있습니다.

OLE DB 공급자는 이진 또는 압축 형식으로 요청과 응답을 지정할 수 있습니다. AMO 및 ADOMD.NET은 텍스트로 요청의 형식을 지정하지만 이진 또는 압축 형식의 응답을 받아들입니다.

이 연결 문자열 속성은 EnableBinaryXML 및 EnableCompression 서버 구성 설정과 동일합니다.

실시간 OLAP

캐싱을 무시하도록 이 속성을 설정하면 모든 스토리지 쿼리가 원본 시스템에서 데이터를 가져옵니다. 기본적으로 이 속성은 설정되지 않습니다.

보안 옵션

사용자 정의 함수 및 동작에 대한 안전 수준을 설정합니다. 유효한 값은 0, 1, 2입니다. Excel 연결에서 이 속성은 안전 옵션=2입니다. 이 옵션에 대한 자세한 내용은 ConnectionString을 참조하세요.

SQLQueryMode

SQL 쿼리에 계산이 포함되는지 여부를 지정합니다. 유효한 값은 Data, Calculated, IncludeEmpty입니다. Data는 계산이 허용되지 않음을 의미합니다. Calculated는 계산을 허용합니다. IncludeEmpty는 계산과 빈 행이 쿼리 결과에 반환될 수 있도록 합니다.

제한 시간

오류를 생성하기 전에 클라이언트 라이브러리가 명령이 완료될 때까지 기다리는 시간(초)을 지정합니다.

전송 압축

클라이언트 및 서버 통신을 압축하는 방법을 정의합니다. 유효한 값은 Default, None, Compressed입니다. 없음은 압축이 사용되지 않음을 나타냅니다. 압축은 XPRESS 압축을 사용합니다.

UseExistingFile

로컬 큐브에 연결할 때 사용됩니다. 이 속성은 로컬 큐브를 덮어쓸지 여부를 지정합니다. 유효한 값은 True 또는 False입니다. True로 설정되면 큐브 파일이 있어야 합니다. 기존 파일은 연결의 대상입니다. False로 설정되면 큐브 파일을 덮어씁니다.

추가 정보

AMO 기본 클래스 - 서버 개체
AdomdConnection 클래스 - 속성