Share via


LocalConnectionString 속성(RDA)

LocalConnectionString 속성은 Microsoft Windows CE 기반 장치의 SQL Server Compact 3.5 데이터베이스에 대한 OLE DB 연결 문자열을 지정합니다.

구문

object.LocalConnectionString(value)

적용 대상

SQL Server Compact 3.5 RDA 개체

데이터 형식

String

수정 가능

읽기/쓰기

프로토타입

HRESULT get_LocalConnectionString(BSTR *pVal);
HRESULT put_LocalConnectionString(BSTR newVal);

일반 매개 변수

매개 변수

설명

value

SQL Server Compact 3.5 데이터베이스에 대한 OLE DB 연결 문자열입니다.

주의

다음 표에서는 OLE DB 연결 문자열의 사용 가능한 속성 이름을 보여 줍니다.

속성

설명

data source

SQL Server Compact 3.5 데이터베이스의 파일 경로 및 이름입니다. 데이터베이스 파일의 상대 경로 대신 절대 경로를 지정합니다.

참고참고
데스크톱 컴퓨터에서 실행되는 응용 프로그램은 장치의 .sdf 파일에 대한 데이터베이스 연결을 열 수 없습니다. 마찬가지로 장치에서 실행되는 응용 프로그램은 데스크톱 컴퓨터의 .sdf 파일에 대한 데이터베이스 연결을 열 수 없습니다.

ssce: database password

데이터베이스 암호이며 최대 40자까지 지정할 수 있습니다. 지정하지 않으면 기본적으로 암호를 사용하지 않습니다. 데이터베이스에 암호화를 설정하는 경우 이 속성은 필수입니다. 암호를 지정하면 데이터베이스에서 암호화 기능을 사용할 수 있습니다. 비어 있는 암호를 지정하면 데이터베이스가 암호화되지 않습니다.

ssce: encrypt database

데이터베이스의 암호화 여부를 결정하는 Boolean 값입니다. 암호화를 사용하려면 true로 설정하고 사용하지 않으려면 false로 설정해야 합니다. 값을 지정하지 않으면 기본값으로 false가 사용됩니다. 또한 암호화를 사용하려면 password 속성을 사용하여 암호를 지정해야 합니다. 암호를 지정하면 이 속성의 설정 방법에 관계없이 암호화를 사용할 수 있습니다. 암호가 지정되면 SSCE:Encrypt Database가 지정되었는지 여부에 상관없이 데이터베이스가 암호화됩니다.

참고참고
encrypt 속성은 향후 릴리스에서 더 이상 사용되지 않습니다. 그러나 이전 버전과의 호환성을 위해 SQL Server Compact 3.5에 유지됩니다.

ssce:encryption mode

또는

encryption mode

이 속성 값은 engine default, platform default 또는 ppc2003 compatibility이며,기본값은 platform default입니다.

ssce: max buffer size

SQL Server Compact 3.5에서 변경 내용을 디스크에 플러시하기 전에 사용할 수 있는 최대 메모리 크기(KB)입니다. 값을 지정하지 않으면 640이 기본값으로 사용됩니다.

ssce: max database size

데이터베이스의 최대 크기(MB)입니다. 값을 지정하지 않으면 128이 기본값으로 사용됩니다.

ssce:mode

데이터베이스 파일을 열 때 사용할 모드입니다. 유효한 값에 대해서는 다음 표를 참조하십시오. 값을 지정하지 않으면 읽기/쓰기가 기본값으로 사용됩니다.

ssce: default lock timeout

트랜잭션의 기본 잠금 대기 시간(밀리초)입니다. 값을 지정하지 않으면 2000이 기본값으로 사용됩니다.

ssce: default lock escalation

행에서 페이지로 또는 페이지에서 테이블로 확대하기 전에 트랜잭션에서 포착할 잠금 수입니다. 값을 지정하지 않으면 100이 기본값으로 사용됩니다.

ssce: flush interval

커밋된 트랜잭션을 모두 디스크에 플러시하기 전의 간격(초)을 지정합니다. 값을 지정하지 않으면 10이 기본값으로 사용됩니다.

ssce: autoshrink threshold

자동 축소를 시작하기 전에 데이터베이스 파일에 허용되는 여유 공간(백분율)입니다. 값이 100이면 자동 축소가 사용되지 않습니다. 값을 지정하지 않으면 60이 기본값으로 사용됩니다.

ssce: temp file directory

임시 데이터베이스의 위치입니다. 위치를 지정하지 않으면 데이터 원본 속성에 임시 저장소로 지정된 데이터베이스가 기본값으로 사용됩니다.

ssce: temp file max size

임시 데이터베이스 파일의 최대 크기(MB)입니다. 값을 지정하지 않으면 128이 기본값으로 사용됩니다.

locale identifier

데이터베이스에 사용할 LCID(로캘 ID)입니다.

ssce:case sensitive

데이터베이스의 대/소문자 구분 여부를 결정하는 부울 값입니다. 대/소문자 구분을 사용하려면 true로 설정하고 사용하지 않으려면 false로 설정합니다. 값을 지정하지 않으면 기본값으로 false가 사용됩니다.

참고참고
이 연결 속성은 SQL Server Compact 3.5 SP1에서 도입되었습니다.

다음 표에서는 연결 문자열의 유효한 mode 속성 값을 보여 줍니다.

정의

읽기/쓰기

여러 프로세스에서 데이터베이스를 열어 수정할 수 있습니다. 모드 속성을 지정하지 않으면 이 값이 기본적으로 설정됩니다.

읽기 전용

데이터베이스를 읽기 전용으로 열 수 있습니다.

배타

다른 프로세스에서 데이터베이스를 열거나 수정할 수 없습니다.

공유 읽기

데이터베이스가 열려 있는 동안 다른 프로세스에서 해당 데이터베이스를 읽을 수 있지만 수정할 수는 없습니다.

연결 문자열에 적용되는 규칙은 다음과 같습니다.

  • 값 또는 따옴표 안에 있는 경우를 제외한 공백 문자는 모두 무시됩니다.

  • 키워드 값 쌍은 세미콜론(;)으로 구분해야 합니다. 또한 세미콜론이 값의 일부이면 따옴표로 구분해야 합니다.

  • 지원되는 이스케이프 시퀀스가 없습니다.

  • 값 유형이 부적절합니다.

  • 이름은 대/소문자를 구분하지 않습니다.

  • 연결 문자열에 속성 이름이 두 번 이상 나오면 마지막에 나오는 속성 이름과 연결된 값이 사용됩니다.

  • 값은 작은따옴표 또는 큰따옴표로 구분할 수 있습니다(예: name='값' 또는 name="값"). 작은따옴표 또는 큰따옴표는 연결 문자열 내에서 다른 구분 기호로 구분될 수 있습니다. 연결 문자열 안에서 따옴표를 올바르게 사용하는 예는 다음과 같습니다.

    "data source='MyDb.sdf'; ssce: mode=Exclusive;"
    'data source="MyDb.sdf"; ssce: mode=Exclusive;'
    
    • 하지만 다음 예는 올바르지 않습니다.
    "data source="MyDb.sdf"; ssce: mode=Exclusive;"
    'data source='MyDb.sdf'; ssce: mode=Exclusive;'
    

참고 항목

관련 자료

RDA 개체 속성