SqlPackage 스크립트 작업은 원본 데이터베이스의 스키마와 일치하도록 대상 데이터베이스의 스키마를 업데이트하는 Transact-SQL 증분 업데이트 스크립트를 만듭니다.
Note
Microsoft Entra ID는 Azure AD(Azure Active Directory)의 새 이름이지만, 기존 환경의 중단을 방지하기 위해 UI 필드, 연결 공급자, 오류 코드 및 cmdlet과 같은 일부 하드 코딩된 요소에는 여전히 Azure AD가 남아 있습니다. 이 문서에서는 두 이름을 서로 교환할 수 있습니다.
Command-line syntax
SqlPackage는 명령줄에 지정된 매개 변수, 속성 및 SQLCMD 변수를 사용하여 지정된 작업을 시작합니다.
SqlPackage {parameters}{properties}{SQLCMD Variables}
스크립트 작업에 대한 매개 변수
| Parameter | Short Form | Value | Description |
|---|---|---|---|
| /AccessToken: | /at | {string} | 대상 데이터베이스에 연결할 때 사용할 토큰 기반 인증 액세스 토큰을 지정합니다. |
| /Action: | /a: | Script | 수행할 작업을 지정합니다. |
| /AzureCloudConfig: | /acc: | {string} | Microsoft Entra ID에 연결하는 데 필요한 사용자 지정 엔드포인트를 AzureActiveDirectoryAuthority={value};DatabaseServicePrincipalName={value}" 형식으로 지정합니다. |
| /DeployReportPath: | /drp: | {string} | 배포 보고서 xml 파일을 출력할 선택적 파일 경로를 지정합니다. |
| /DeployScriptPath: | /dsp: | {string} | 배포 스크립트를 출력할 선택적 파일 경로를 지정합니다. Azure 배포의 경우 마스터 데이터베이스를 만들거나 수정하는 Transact-SQL 명령이 있는 경우 스크립트는 출력 파일 이름과 "Filename_Master.sql"을 사용하여 동일한 경로에 기록됩니다. |
| /Diagnostics: | /d: | {True|False} | 진단 로깅이 콘솔로 출력되는지 여부를 지정합니다. 기본값은 False입니다. |
| /DiagnosticsFile: | /df: | {string} | 진단 로그를 저장할 파일을 지정합니다. |
| /DiagnosticsLevel: | /dl | {None|Off|Critical|Error|Warning|Information|Verbose} | 필터링된 진단 파일의 추적 메시지 수준을 지정합니다. |
| /MaxParallelism: | /mp: | {int} | 데이터베이스에 대해 실행되는 동시 작업에 대한 병렬 처리 수준을 지정합니다. 기본값은 8입니다. |
| /ModelFilePath: | /mfp: | {string} | 원본 파일에서 model.xml을 재정의할 파일 경로를 지정합니다. 이 설정을 사용하면 배포 실패 및/또는 의도하지 않은 데이터 손실이 발생할 수 있습니다. 이 설정은 게시, 가져오기 또는 스크립트 생성과 관련된 문제를 해결할 때만 사용할 수 있습니다. |
| /OutputPath: | /op: | {string} | 출력 파일이 생성되는 파일 경로를 지정합니다. |
| /OverwriteFiles: | /of: | {True|False} | SqlPackage가 기존 파일을 덮어쓸지 여부를 지정합니다. false를 지정하면 기존 파일이 발견되면 SqlPackage가 작업을 중단합니다. 기본값은 True입니다. |
| /Profile: | /pr: | {string} | DAC 게시 프로필의 파일 경로를 지정합니다. 프로필은 출력을 생성할 때 사용할 속성 및 변수 컬렉션을 정의합니다. |
| /Properties: | /p: | {PropertyName}={Value} | 작업별 속성에 대한 이름 값 쌍을 지정합니다. {PropertyName}={Value}. |
| /Quiet: | /q: | {True|False} | 자세한 피드백을 무시할지 여부를 지정합니다. 기본값은 False입니다. |
| /ReferencePaths: | /rp: | {PropertyName}={Value} | .dacpac 참조를 검색할 추가 디렉터리를 지정합니다. |
| /SourceFile: | /sf: | {string} | 작업의 원본으로 사용할 원본 파일을 지정합니다. 이 매개 변수를 사용하는 경우 다른 원본 매개 변수는 유효하지 않습니다. |
| /SourceConnectionString: | /scs: | {string} | 원본 데이터베이스에 대한 유효한 SQL Server/Azure 연결 문자열을 지정합니다. 이 매개 변수를 지정하면 다른 모든 원본 매개 변수를 제외하고 이 매개 변수만 사용해야 합니다. |
| /SourceDatabaseName: | /sdn: | {string} | 원본 데이터베이스의 이름을 정의합니다. |
| /SourceEncryptConnection: | /sec: | {Optional|Mandatory|Strict|True|False} | 원본 데이터베이스 연결에 대해 SQL 암호화를 사용할지 여부를 지정합니다. 기본값은 True입니다. |
| /SourceHostNameInCertificate: | /shnic: | {string} | 통신 계층이 TLS를 사용하여 암호화될 때 원본 SQL Server TLS/SSL 인증서의 유효성을 검사하는 데 사용되는 값을 지정합니다. |
| /SourcePassword: | /sp: | {string} | SQL Server 인증 시나리오의 경우 원본 데이터베이스에 액세스하는 데 사용할 암호를 정의합니다. |
| /SourceServerName: | /ssn: | {string} | 원본 데이터베이스를 호스팅하는 서버의 이름을 정의합니다. |
| /SourceTimeout: | /st: | {int} | 원본 데이터베이스에 대한 연결을 설정하기 위한 시간 제한(초)을 지정합니다. |
| /SourceTrustServerCertificate: | /stsc: | {True|False} | TLS를 사용하여 원본 데이터베이스 연결을 암호화하고 인증서 체인을 건너뛰어 신뢰의 유효성을 검사할지 여부를 지정합니다. 기본값은 False입니다. |
| /SourceUser: | /su: | {string} | SQL Server 인증 시나리오의 경우 원본 데이터베이스에 액세스하는 데 사용할 SQL Server 사용자를 정의합니다. |
| /TargetFile: | /tf: | {string} | 데이터베이스 대신 작업의 대상으로 사용할 대상 파일(즉, .dacpac 파일)을 지정합니다. 이 매개 변수를 사용하는 경우 다른 대상 매개 변수는 유효하지 않습니다. 이 매개 변수는 데이터베이스 대상만 지원하는 작업에 유효하지 않습니다. |
| /TargetConnectionString: | /tcs: | {string} | 대상 데이터베이스에 대한 유효한 SQL Server/Azure 연결 문자열을 지정합니다. 이 매개 변수가 지정되면 다른 모든 대상 매개 변수를 제외하고 이 매개 변수만 사용해야 합니다. |
| /TargetDatabaseName: | /tdn: | {string} | SqlPackage 작업의 대상인 데이터베이스 이름에 대한 재정의를 지정합니다. |
| /TargetEncryptConnection: | /tec: | {Optional|Mandatory|Strict|True|False} | 대상 데이터베이스 연결에 대해 SQL 암호화를 사용할지 여부를 지정합니다. 기본값은 True입니다. |
| /TargetHostNameInCertificate: | /thnic: | {string} | 통신 계층이 TLS를 사용하여 암호화될 때 대상 SQL Server TLS/SSL 인증서의 유효성을 검사하는 데 사용되는 값을 지정합니다. |
| /TargetPassword: | /tp: | {string} | SQL Server 인증 시나리오의 경우 대상 데이터베이스에 액세스하는 데 사용할 암호를 정의합니다. |
| /TargetServerName: | /tsn: | {string} | 대상 데이터베이스를 호스팅하는 서버의 이름을 정의합니다. |
| /TargetTimeout: | /tt: | {int} | 대상 데이터베이스에 대한 연결을 설정하기 위한 시간 제한(초)을 지정합니다. Microsoft Entra ID의 경우 이 값이 30초보다 크거나 같은 것이 좋습니다. |
| /TargetTrustServerCertificate: | /ttsc: | {True|False} | TLS를 사용하여 대상 데이터베이스 연결을 암호화하고 인증서 체인을 건너뛰어 신뢰의 유효성을 검사할지 여부를 지정합니다. 기본값은 False입니다. |
| /TargetUser: | /tu: | {string} | SQL Server 인증 시나리오의 경우 대상 데이터베이스에 액세스하는 데 사용할 SQL Server 사용자를 정의합니다. |
| /TenantId: | /tid: | {string} | Microsoft Entra 테넌트 ID 또는 도메인 이름을 나타냅니다. 이 옵션은 Microsoft Entra 게스트 사용자뿐만 아니라 outlook.com, hotmail.com 또는 live.com 같은 Microsoft 계정을 지원하는 데 필요합니다. 이 매개 변수를 생략하면 인증된 사용자가 이 테넌트의 네이티브 사용자라고 가정하면 Microsoft Entra ID의 기본 테넌트 ID가 사용됩니다. 그러나 이 경우 이 Microsoft Entra ID에 호스트된 게스트 사용자 또는 Microsoft 계정은 지원되지 않으며 작업이 실패합니다. |
| /ThreadMaxStackSize: | /tmss: | {int} | SqlPackage 작업을 실행하는 스레드의 최대 크기(MB)를 지정합니다. 이 옵션은 매우 큰 Transact-SQL 문을 구문 분석할 때 발생하는 스택 오버플로 예외가 발생하는 경우에만 사용해야 합니다. |
| /UniversalAuthentication: | /ua: | {True|False} | 유니버설 인증을 사용해야 하는지 여부를 지정합니다. True로 설정하면 MFA를 지원하는 대화형 인증 프로토콜이 활성화됩니다. 이 옵션은 사용자가 사용자 이름 및 암호를 입력하도록 요구하는 대화형 프로토콜 또는 통합 인증(페더레이션 Windows 자격 증명 사용)을 사용하여 MFA 없이 Microsoft Entra 인증에 사용할 수도 있습니다. /UniversalAuthentication이 True로 설정된 경우 SourceConnectionString(/scs)에서 Microsoft Entra 인증을 지정할 수 없습니다. /UniversalAuthentication이 False로 설정되면 SourceConnectionString(/scs)에서 Microsoft Entra 인증을 지정해야 합니다. 자세한 내용은 Microsoft Entra 다단계 인증 사용을 참조하세요. |
| /Variables: | /v: | {PropertyName}={Value} | 작업별 변수에 대한 이름 값 쌍을 지정합니다. {VariableName}={Value}. DACPAC 파일에는 유효한 SQLCMD 변수 목록이 포함되어 있습니다. 모든 변수에 대해 값이 제공되지 않으면 오류가 발생합니다. |
스크립트 작업과 관련된 속성
| Property | Value | Description |
|---|---|---|
| /p: | AdditionalDeploymentContributorArguments=(STRING) | 배포 기여자에 대한 추가 배포 설정 인수를 지정합니다. 세미콜론으로 구분된 값 목록이어야 합니다. |
| /p: | AdditionalDeploymentContributors=(STRING) | dacpac가 배포될 때 실행되어야 하는 추가 배포 기여자를 지정합니다. 정규화된 빌드 참가자 이름 또는 ID의 세미콜론으로 구분된 목록이어야 합니다. |
| /p: | AdditionalDeploymentContributorPaths=(STRING) | 추가 배포 참가자를 로드하는 경로를 지정합니다. 세미콜론으로 구분된 값 목록이어야 합니다. |
| /p: | AllowDropBlockingAssemblies=(BOOLEAN) | 이 속성은 SqlClr 배포에서 모든 차단 어셈블리를 배포 계획의 일부로 삭제하는 데 사용됩니다. 기본적으로 모든 차단/참조 어셈블리는 참조하는 어셈블리를 삭제해야 하는 경우 어셈블리 업데이트를 차단합니다. |
| /p: | AllowExternalLanguagePaths=(BOOLEAN 'False') | 사용 가능한 경우 외부 언어 문을 생성하는 데 파일 경로를 사용하도록 허용합니다. |
| /p: | AllowExternalLibraryPaths=(BOOLEAN 'False') | 사용 가능한 경우 외부 라이브러리 문을 생성하는 데 파일 경로를 사용하도록 허용합니다. |
| /p: | AllowIncompatiblePlatform=(BOOLEAN) | 호환되지 않는 SQL Server 플랫폼에도 불구하고 작업을 시도할지 여부를 지정합니다. |
| /p: | AllowUnsafeRowLevelSecurityDataMovement=(BOOLEAN) | 이 속성이 true로 설정된 경우 행 수준 보안이 있는 테이블에서 데이터 동작을 차단하지 마세요. 기본값은 false입니다. |
| /p: | BackupDatabaseBeforeChanges=(BOOLEAN) | 변경 내용을 배포하기 전에 데이터베이스를 백업합니다. |
| /p: | BlockOnPossibleDataLoss=(BOOLEAN 'True') | 결과 스키마 변경으로 인해 데이터 정밀도 감소나 데이터 형식 변경(캐스트 작업 필요)으로 데이터 손실이 발생할 수 있는 경우, 스키마 유효성 검사 단계에서 작업이 종료되도록 명시합니다. 기본(True) 값은 대상 데이터베이스에 데이터가 포함되어 있는지 여부에 관계없이 작업을 종료합니다. 새 열 형식으로 변환할 수 없는 데이터가 대상에 있는 경우 배포 계획 실행 중에 BlockOnPossibleDataLoss에 대한 False 값이 있는 실행은 여전히 실패할 수 있습니다. |
| /p: | BlockWhenDriftDetected=(BOOLEAN 'True') | 스키마가 더 이상 등록과 일치하지 않거나 등록이 취소된 데이터베이스의 업데이트를 차단할지 여부를 지정합니다. |
| /p: | CommandTimeout=(INT32 '60') | SQL Server에 대해 쿼리를 실행할 때 명령 제한 시간(초)을 지정합니다. |
| /p: | CommentOutSetVarDeclarations=(BOOLEAN) | 생성된 게시 스크립트에서 SETVAR 변수 선언을 주석 처리할지 여부를 지정합니다. SQLCMD.EXE 같은 도구를 사용하여 게시할 때 명령줄의 값을 지정하려는 경우 이 작업을 수행할 수 있습니다. |
| /p: | CompareUsingTargetCollation=(BOOLEAN) | 이 설정은 배포 중에 데이터베이스의 데이터 정렬을 처리하는 방법을 지정합니다. 기본적으로 대상 데이터베이스의 데이터 정렬은 원본에서 지정한 데이터 정렬과 일치하지 않는 경우 업데이트됩니다. 이 옵션을 설정하면 대상 데이터베이스(또는 서버의) 데이터 정렬을 사용해야 합니다. |
| /p: | CreateNewDatabase=(BOOLEAN) | 데이터베이스에 게시할 때 대상 데이터베이스를 업데이트할지 또는 삭제 후 다시 만들지 여부를 지정합니다. |
| /p: | DatabaseEdition=({ Basic | 표준 | 프리미엄 | 데이터웨어하우스 | 일반용도 | 비즈니스 크리티컬 | 하이퍼스케일 | 기본 } '기본값') | Azure SQL Database의 버전을 정의합니다. Azure SQL Database 서비스 계층을 참조하세요. |
| /p: | DatabaseLockTimeout=(INT32 '60') | SQLServer에 대해 쿼리를 실행할 때 데이터베이스 잠금 시간 제한(초)을 지정합니다. 무기한 대기하려면 -1을 사용합니다. |
| /p: | DatabaseMaximumSize=(INT32) | Azure SQL Database의 최대 크기(GB)를 정의합니다. |
| /p: | DatabaseServiceObjective=(STRING) | "P0" 또는 "S1"과 같은 Azure SQL Database의 성능 수준을 정의합니다. |
| /p: | DeployDatabaseInSingleUserMode=(BOOLEAN) | True인 경우 배포 전에 데이터베이스가 단일 사용자 모드로 설정됩니다. |
| /p: | DisableAndReenableDdlTriggers=(BOOLEAN 'True') | 게시 프로세스의 시작 부분에서 DDL(데이터 정의 언어) 트리거를 사용하지 않도록 설정하고 게시 작업이 끝날 때 다시 사용하도록 설정할지 여부를 지정합니다. |
| /p: | DoNotAlterChangeDataCaptureObjects=(BOOLEAN 'True') | True인 경우 변경 데이터 캡처 개체가 수정되지 않습니다. |
| /p: | DoNotAlterReplicatedObjects=(BOOLEAN 'True') | 복제된 개체가 확인 중에 식별되는지 여부를 지정합니다. |
| /p: | DoNotDropObjectType=(STRING) | DropObjectsNotInSource가 true일 때 삭제해서는 안 되는 개체 형식입니다. 유효한 개체 유형 이름은 집합체(Aggregates), 응용 프로그램 역할(ApplicationRoles), 어셈블리(Assemblies), 어셈블리 파일(AssemblyFiles), 비대칭 키(AsymmetricKeys), 브로커 우선순위(BrokerPriorities), 인증서(Certificates), 열 암호화 키(ColumnEncryptionKeys), 열 주 키(ColumnMasterKeys), 계약(Contracts), 데이터베이스 옵션(DatabaseOptions), 데이터베이스 역할(DatabaseRoles), 데이터베이스 트리거(DatabaseTriggers), 기본값(Defaults), 확장 속성(ExtendedProperties), 외부 데이터 소스(ExternalDataSources), 외부 파일 형식(ExternalFileFormats), 외부 테이블(ExternalTables), 파일 그룹(Filegroups), 파일(Files), 파일 테이블(FileTables), 전체 텍스트 카탈로그(FullTextCatalogs), 전체 텍스트 중지 목록(FullTextStoplists), 메시지 유형(MessageTypes), 파티션 함수(PartitionFunctions), 파티션 체계(PartitionSchemes), 권한(Permissions), 큐(Queues), 원격 서비스 바인딩(RemoteServiceBindings), 역할 멤버십(RoleMembership), 규칙(Rules), 스칼라 값 함수(ScalarValuedFunctions), 검색 속성 목록(SearchPropertyLists), 보안 정책(SecurityPolicies), 시퀀스(Sequences), 서비스(Services), 서명(Signatures), 저장 프로시저(StoredProcedures), 대칭 키(SymmetricKeys), 동의어(Synonyms), 테이블(Tables), 테이블 값 함수(TableValuedFunctions), 사용자 정의 데이터 유형(UserDefinedDataTypes), 사용자 정의 테이블 유형(UserDefinedTableTypes), 클립(ClrUserDefinedTypes), 사용자(Users), 뷰(Views), XML 스키마 모음(XmlSchemaCollections), 감사(Audits), 자격 증명(Credentials), 암호화 제공자(CryptographicProviders), 데이터베이스 감사 사양(DatabaseAuditSpecifications), 데이터베이스 암호화 키(DatabaseEncryptionKeys), 데이터베이스 범위 자격 증명(DatabaseScopedCredentials), 엔드포인트(Endpoints), 오류 메시지(ErrorMessages), 이벤트 알림(EventNotifications), 이벤트 세션(EventSessions), 연결된 서버 로그인(LinkedServerLogins), 연결된 서버(LinkedServers), 로그인(Logins), 주 키(MasterKeys), 경로(Routes), 서버 감사 사양(ServerAuditSpecifications), 서버 역할 멤버십(ServerRoleMembership), 서버 역할(ServerRoles), 서버 트리거(ServerTriggers), 외부 스트림(ExternalStreams), 외부 스트리밍 작업(ExternalStreamingJobs), 데이터베이스 워크로드 그룹(DatabaseWorkloadGroups), 워크로드 분류자(WorkloadClassifiers), 외부 라이브러리(ExternalLibraries), 외부 언어(ExternalLanguages)입니다. 이 속성은 여러 옵션을 나타내기 위해 여러 번 지정할 수 있습니다. |
| /p: | DoNotDropObjectTypes=(STRING) | DropObjectsNotInSource가 true일 때 삭제해서는 안 되는 개체 형식의 세미콜론으로 구분된 목록입니다. 유효한 개체 유형 이름은 집합체(Aggregates), 응용 프로그램 역할(ApplicationRoles), 어셈블리(Assemblies), 어셈블리 파일(AssemblyFiles), 비대칭 키(AsymmetricKeys), 브로커 우선순위(BrokerPriorities), 인증서(Certificates), 열 암호화 키(ColumnEncryptionKeys), 열 주 키(ColumnMasterKeys), 계약(Contracts), 데이터베이스 옵션(DatabaseOptions), 데이터베이스 역할(DatabaseRoles), 데이터베이스 트리거(DatabaseTriggers), 기본값(Defaults), 확장 속성(ExtendedProperties), 외부 데이터 소스(ExternalDataSources), 외부 파일 형식(ExternalFileFormats), 외부 테이블(ExternalTables), 파일 그룹(Filegroups), 파일(Files), 파일 테이블(FileTables), 전체 텍스트 카탈로그(FullTextCatalogs), 전체 텍스트 중지 목록(FullTextStoplists), 메시지 유형(MessageTypes), 파티션 함수(PartitionFunctions), 파티션 체계(PartitionSchemes), 권한(Permissions), 큐(Queues), 원격 서비스 바인딩(RemoteServiceBindings), 역할 멤버십(RoleMembership), 규칙(Rules), 스칼라 값 함수(ScalarValuedFunctions), 검색 속성 목록(SearchPropertyLists), 보안 정책(SecurityPolicies), 시퀀스(Sequences), 서비스(Services), 서명(Signatures), 저장 프로시저(StoredProcedures), 대칭 키(SymmetricKeys), 동의어(Synonyms), 테이블(Tables), 테이블 값 함수(TableValuedFunctions), 사용자 정의 데이터 유형(UserDefinedDataTypes), 사용자 정의 테이블 유형(UserDefinedTableTypes), 클립(ClrUserDefinedTypes), 사용자(Users), 뷰(Views), XML 스키마 모음(XmlSchemaCollections), 감사(Audits), 자격 증명(Credentials), 암호화 제공자(CryptographicProviders), 데이터베이스 감사 사양(DatabaseAuditSpecifications), 데이터베이스 암호화 키(DatabaseEncryptionKeys), 데이터베이스 범위 자격 증명(DatabaseScopedCredentials), 엔드포인트(Endpoints), 오류 메시지(ErrorMessages), 이벤트 알림(EventNotifications), 이벤트 세션(EventSessions), 연결된 서버 로그인(LinkedServerLogins), 연결된 서버(LinkedServers), 로그인(Logins), 주 키(MasterKeys), 경로(Routes), 서버 감사 사양(ServerAuditSpecifications), 서버 역할 멤버십(ServerRoleMembership), 서버 역할(ServerRoles), 서버 트리거(ServerTriggers), 외부 스트림(ExternalStreams), 외부 스트리밍 작업(ExternalStreamingJobs), 데이터베이스 워크로드 그룹(DatabaseWorkloadGroups), 워크로드 분류자(WorkloadClassifiers), 외부 라이브러리(ExternalLibraries), 외부 언어(ExternalLanguages)입니다. |
| /p: | DoNotDropWorkloadClassifiers=(BOOLEAN 'False') | false인 경우 원본에 정의되어 있지 않은 대상 데이터베이스의 WorkloadClassifier가 배포 중에 삭제됩니다. |
| /p: | DoNotEvaluateSqlCmdVariables=(BOOLEAN 'True') | SQLCMD 변수를 값으로 바꾸지 않을지 여부를 지정합니다. |
| /p: | DropConstraintsNotInSource=(BOOLEAN 'True') | 데이터베이스에 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 없는 제약 조건을 대상 데이터베이스에서 삭제할지 여부를 지정합니다. |
| /p: | DropDmlTriggersNotInSource=(BOOLEAN 'True') | 데이터베이스에 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 없는 DML 트리거를 대상 데이터베이스에서 삭제할지 여부를 지정합니다. |
| /p: | DropExtendedPropertiesNotInSource=(BOOLEAN 'True') | 데이터베이스에 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 없는 확장 속성을 대상 데이터베이스에서 삭제할지 여부를 지정합니다. |
| /p: | DropIndexesNotInSource=(BOOLEAN 'True') | 데이터베이스에 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 없는 인덱스를 대상 데이터베이스에서 삭제할지 여부를 지정합니다. |
| /p: | DropObjectsNotInSource=(BOOLEAN) | 데이터베이스에 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 없는 개체를 대상 데이터베이스에서 삭제할지 여부를 지정합니다. 이 값은 DropExtendedProperties보다 우선합니다. |
| /p: | DropPermissionsNotInSource=(BOOLEAN) | 데이터베이스에 업데이트를 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 없는 사용 권한을 대상 데이터베이스에서 삭제할지 여부를 지정합니다. |
| /p: | DropRoleMembersNotInSource=(BOOLEAN) | 데이터베이스에 업데이트를 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 정의되지 않은 역할 멤버를 대상 데이터베이스에서 삭제할지 여부를 지정합니다. |
| /p: | DropStatisticsNotInSource=(BOOLEAN 'True') | 데이터베이스에 게시할 때 데이터베이스 스냅샷(.dacpac) 파일에 없는 통계를 대상 데이터베이스에서 삭제할지 여부를 지정합니다. |
| /p: | EnclaveAttestationProtocol=(STRING) | Enclave 기반 Always Encrypted와 함께 사용할 증명 프로토콜을 지정합니다. |
| /p: | EnclaveAttestationUrl=(STRING) | Enclave 기반 Always Encrypted와 함께 사용할 Enclave 증명 URL(증명 서비스 엔드포인트)을 지정합니다. |
| /p: | ExcludeObjectType=(STRING) | 배포 중에 무시되어야 하는 개체 유형입니다. 유효한 개체 유형 이름은 집합체(Aggregates), 응용 프로그램 역할(ApplicationRoles), 어셈블리(Assemblies), 어셈블리 파일(AssemblyFiles), 비대칭 키(AsymmetricKeys), 브로커 우선순위(BrokerPriorities), 인증서(Certificates), 열 암호화 키(ColumnEncryptionKeys), 열 주 키(ColumnMasterKeys), 계약(Contracts), 데이터베이스 옵션(DatabaseOptions), 데이터베이스 역할(DatabaseRoles), 데이터베이스 트리거(DatabaseTriggers), 기본값(Defaults), 확장 속성(ExtendedProperties), 외부 데이터 소스(ExternalDataSources), 외부 파일 형식(ExternalFileFormats), 외부 테이블(ExternalTables), 파일 그룹(Filegroups), 파일(Files), 파일 테이블(FileTables), 전체 텍스트 카탈로그(FullTextCatalogs), 전체 텍스트 중지 목록(FullTextStoplists), 메시지 유형(MessageTypes), 파티션 함수(PartitionFunctions), 파티션 체계(PartitionSchemes), 권한(Permissions), 큐(Queues), 원격 서비스 바인딩(RemoteServiceBindings), 역할 멤버십(RoleMembership), 규칙(Rules), 스칼라 값 함수(ScalarValuedFunctions), 검색 속성 목록(SearchPropertyLists), 보안 정책(SecurityPolicies), 시퀀스(Sequences), 서비스(Services), 서명(Signatures), 저장 프로시저(StoredProcedures), 대칭 키(SymmetricKeys), 동의어(Synonyms), 테이블(Tables), 테이블 값 함수(TableValuedFunctions), 사용자 정의 데이터 유형(UserDefinedDataTypes), 사용자 정의 테이블 유형(UserDefinedTableTypes), 클립(ClrUserDefinedTypes), 사용자(Users), 뷰(Views), XML 스키마 모음(XmlSchemaCollections), 감사(Audits), 자격 증명(Credentials), 암호화 제공자(CryptographicProviders), 데이터베이스 감사 사양(DatabaseAuditSpecifications), 데이터베이스 암호화 키(DatabaseEncryptionKeys), 데이터베이스 범위 자격 증명(DatabaseScopedCredentials), 엔드포인트(Endpoints), 오류 메시지(ErrorMessages), 이벤트 알림(EventNotifications), 이벤트 세션(EventSessions), 연결된 서버 로그인(LinkedServerLogins), 연결된 서버(LinkedServers), 로그인(Logins), 주 키(MasterKeys), 경로(Routes), 서버 감사 사양(ServerAuditSpecifications), 서버 역할 멤버십(ServerRoleMembership), 서버 역할(ServerRoles), 서버 트리거(ServerTriggers), 외부 스트림(ExternalStreams), 외부 스트리밍 작업(ExternalStreamingJobs), 데이터베이스 워크로드 그룹(DatabaseWorkloadGroups), 워크로드 분류자(WorkloadClassifiers), 외부 라이브러리(ExternalLibraries), 외부 언어(ExternalLanguages)입니다. |
| /p: | ExcludeObjectTypes=(STRING) | 배포 중에 무시해야 하는 개체 형식의 세미콜론으로 구분된 목록입니다. 유효한 개체 유형 이름은 집합체(Aggregates), 응용 프로그램 역할(ApplicationRoles), 어셈블리(Assemblies), 어셈블리 파일(AssemblyFiles), 비대칭 키(AsymmetricKeys), 브로커 우선순위(BrokerPriorities), 인증서(Certificates), 열 암호화 키(ColumnEncryptionKeys), 열 주 키(ColumnMasterKeys), 계약(Contracts), 데이터베이스 옵션(DatabaseOptions), 데이터베이스 역할(DatabaseRoles), 데이터베이스 트리거(DatabaseTriggers), 기본값(Defaults), 확장 속성(ExtendedProperties), 외부 데이터 소스(ExternalDataSources), 외부 파일 형식(ExternalFileFormats), 외부 테이블(ExternalTables), 파일 그룹(Filegroups), 파일(Files), 파일 테이블(FileTables), 전체 텍스트 카탈로그(FullTextCatalogs), 전체 텍스트 중지 목록(FullTextStoplists), 메시지 유형(MessageTypes), 파티션 함수(PartitionFunctions), 파티션 체계(PartitionSchemes), 권한(Permissions), 큐(Queues), 원격 서비스 바인딩(RemoteServiceBindings), 역할 멤버십(RoleMembership), 규칙(Rules), 스칼라 값 함수(ScalarValuedFunctions), 검색 속성 목록(SearchPropertyLists), 보안 정책(SecurityPolicies), 시퀀스(Sequences), 서비스(Services), 서명(Signatures), 저장 프로시저(StoredProcedures), 대칭 키(SymmetricKeys), 동의어(Synonyms), 테이블(Tables), 테이블 값 함수(TableValuedFunctions), 사용자 정의 데이터 유형(UserDefinedDataTypes), 사용자 정의 테이블 유형(UserDefinedTableTypes), 클립(ClrUserDefinedTypes), 사용자(Users), 뷰(Views), XML 스키마 모음(XmlSchemaCollections), 감사(Audits), 자격 증명(Credentials), 암호화 제공자(CryptographicProviders), 데이터베이스 감사 사양(DatabaseAuditSpecifications), 데이터베이스 암호화 키(DatabaseEncryptionKeys), 데이터베이스 범위 자격 증명(DatabaseScopedCredentials), 엔드포인트(Endpoints), 오류 메시지(ErrorMessages), 이벤트 알림(EventNotifications), 이벤트 세션(EventSessions), 연결된 서버 로그인(LinkedServerLogins), 연결된 서버(LinkedServers), 로그인(Logins), 주 키(MasterKeys), 경로(Routes), 서버 감사 사양(ServerAuditSpecifications), 서버 역할 멤버십(ServerRoleMembership), 서버 역할(ServerRoles), 서버 트리거(ServerTriggers), 외부 스트림(ExternalStreams), 외부 스트리밍 작업(ExternalStreamingJobs), 데이터베이스 워크로드 그룹(DatabaseWorkloadGroups), 워크로드 분류자(WorkloadClassifiers), 외부 라이브러리(ExternalLibraries), 외부 언어(ExternalLanguages)입니다. |
| /p: | GenerateSmartDefaults=(BOOLEAN) | null 값을 허용하지 않는 열이 있는 데이터를 포함하는 테이블을 업데이트할 때 자동으로 기본값을 제공합니다. |
| /p: | HashObjectNamesInLogs=(BOOLEAN 'False') | 로그의 모든 개체 이름을 임의의 해시 값으로 바꿀지 여부를 지정합니다. |
| /p: | IgnoreAnsiNulls=(BOOLEAN 'True') | 데이터베이스에 게시할 때 ANSI NULLS 설정의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreAuthorizer=(BOOLEAN) | 데이터베이스에 게시할 때 권한 부여자의 차이점을 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreColumnCollation=(BOOLEAN) | 데이터베이스에 게시할 때 열 데이터 정렬의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreColumnOrder=(BOOLEAN) | 데이터베이스에 게시할 때 테이블 열 순서의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreComments=(BOOLEAN) | 데이터베이스에 게시할 때 주석의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreCryptographicProviderFilePath=(BOOLEAN 'True') | 데이터베이스에 게시할 때 암호화 공급자에 대한 파일 경로의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreDatabaseWorkloadGroups=(BOOLEAN 'False') | 배포하는 동안 대상에 있는 워크로드 그룹을 제외할지 여부를 지정합니다. 데이터베이스 워크로드 그룹은 추가, 수정 또는 삭제되지 않습니다. |
| /p: | IgnoreDdlTriggerOrder=(BOOLEAN) | 데이터베이스 또는 서버에 게시할 때 DDL(데이터 정의 언어) 트리거 순서의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreDdlTriggerState=(BOOLEAN) | 데이터베이스에 게시할 때 DDL(데이터 정의 언어) 트리거의 사용 또는 사용 안 함 상태의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreDefaultSchema=(BOOLEAN) | 데이터베이스에 게시할 때 기본 스키마의 차이점을 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreDmlTriggerOrder=(BOOLEAN) | 데이터베이스에 게시할 때 DML(데이터 조작 언어) 트리거 순서의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreDmlTriggerState=(BOOLEAN) | 데이터베이스에 게시할 때 DML 트리거 사용/사용 안 함 상태의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreExtendedProperties=(BOOLEAN) | 데이터베이스에 게시할 때 확장 속성의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreFileAndLogFilePath=(BOOLEAN 'True') | 데이터베이스에 게시할 때 파일 및 로그 파일 경로의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreFilegroupPlacement=(BOOLEAN 'True') | 데이터베이스에 게시할 때 FILEGROUP에서 개체 배치의 차이를 무시하거나 업데이트해야 하는지 여부를 지정합니다. |
| /p: | IgnoreFileSize=(BOOLEAN 'True') | 데이터베이스에 게시할 때 파일 크기의 차이를 무시할지 또는 경고를 발생하도록 할지를 지정합니다. |
| /p: | IgnoreFillFactor=(BOOLEAN 'True') | 인덱스 스토리지의 채우기 비율 차이를 무시할지 또는 게시할 때 경고를 발생시켜야 하는지 여부를 지정합니다. |
| /p: | IgnoreFullTextCatalogFilePath=(BOOLEAN 'True') | 전체 텍스트에 대한 파일 경로의 차이를 무시할지 또는 데이터베이스에 게시할 때 경고를 실행할지 여부를 지정합니다. |
| /p: | IgnoreIdentitySeed=(BOOLEAN) | 데이터베이스에 업데이트를 게시할 때 ID 열의 시드 차이를 무시할지 아니면 업데이트할지를 지정합니다. |
| /p: | IgnoreIncrement=(BOOLEAN) | 데이터베이스에 게시할 때 ID 열의 증분 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreIndexOptions=(BOOLEAN) | 데이터베이스에 게시할 때 인덱스 옵션의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreIndexPadding=(BOOLEAN 'True') | 데이터베이스에 게시할 때 인덱스 패딩의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreKeywordCasing=(BOOLEAN 'True') | 데이터베이스에 게시할 때 키워드 대/소문자 구분의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreLockHintsOnIndexes=(BOOLEAN) | 데이터베이스에 게시할 때 인덱스에 대한 잠금 힌트의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreLoginSids=(BOOLEAN 'True') | 데이터베이스에 게시할 때 SID(보안 ID)의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreNotForReplication=(BOOLEAN) | 데이터베이스에 게시할 때 복제 안 함 설정을 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreObjectPlacementOnPartitionScheme=(BOOLEAN 'True') | 데이터베이스에 게시할 때 파티션 구성표에 대한 개체의 배치를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnorePartitionSchemes=(BOOLEAN) | 데이터베이스에 게시할 때 파티션 구성표와 함수의 차이를 무시하거나 업데이트해야 하는지 여부를 지정합니다. |
| /p: | IgnorePermissions=(BOOLEAN) | 데이터베이스에 게시할 때 사용 권한의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnorePostDeployScript=(BOOLEAN 'False') | true이면 .dacpac의 배포 후 스크립트가 배포 계획에 연결되지 않습니다. |
| /p: | IgnorePreDeployScript=(BOOLEAN 'False') | true이면 .dacpac의 배포 전 스크립트가 배포 계획에 연결되지 않습니다. |
| /p: | IgnoreQuotedIdentifiers=(BOOLEAN 'True') | 데이터베이스에 게시할 때 따옴표 붙은 식별자 설정의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreRoleMembership=(BOOLEAN) | 데이터베이스에 게시할 때 로그인 역할 멤버 자격의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreRouteLifetime=(BOOLEAN 'True') | 데이터베이스에 게시할 때 SQL Server가 라우팅 테이블에 경로를 유지하는 시간에 대한 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreSemicolonBetweenStatements=(BOOLEAN 'True') | 데이터베이스에 게시할 때 T-SQL 문 간의 세미콜론 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreSensitivityClassifications=(BOOLEAN 'False') | 스키마 모델을 비교할 때 열의 데이터 민감도 분류를 무시할지 여부를 지정합니다. 이는 SQL 2019에 도입된 ADD SENSITIVITY CLASSIFICATION 구문으로 추가된 분류에 대해서만 작동합니다. |
| /p: | IgnoreTableOptions=(BOOLEAN) | 데이터베이스에 게시할 때 테이블 옵션의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreTablePartitionOptions=(BOOLEAN) | 데이터베이스에 게시할 때 테이블 파티션 옵션의 차이를 무시할지 또는 업데이트할지를 지정합니다. 이 옵션은 Azure Synapse Analytics 데이터 웨어하우스 데이터베이스에만 적용됩니다. |
| /p: | IgnoreUserSettingsObjects=(BOOLEAN) | 데이터베이스에 게시할 때 사용자 설정 개체의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreWhitespace=(BOOLEAN 'True') | 데이터베이스에 게시할 때 공백의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreWithNocheckOnCheckConstraints=(BOOLEAN) | 데이터베이스에 게시할 때 CHECK 제약 조건의 WITH NOCHECK 절에 대한 값의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreWithNocheckOnForeignKeys=(BOOLEAN) | 데이터베이스에 게시할 때 외래 키의 WITH NOCHECK 절에 대한 값의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreWorkloadClassifiers=(BOOLEAN 'False') | 배포하는 동안 대상에 있는 워크로드 분류자를 제외할지 여부를 지정합니다. |
| /p: | IncludeCompositeObjects=(BOOLEAN) | 단일 게시 작업의 일부로 동일한 데이터베이스를 가진 모든 복합 요소를 포함합니다. |
| /p: | IncludeTransactionalScripts=(BOOLEAN) | 데이터베이스에 게시할 때 가능한 경우 트랜잭션 문을 사용할지 여부를 지정합니다. |
| /p: | IsAlwaysEncryptedParameterizationEnabled=(BOOLEAN 'False') | 배포 전/후 스크립트의 Always Encrypted 열에서 변수 매개 변수화를 사용하도록 설정합니다. |
| /p: | LongRunningCommandTimeout=(INT32 '0') | SQL Server에 대해 쿼리를 실행할 때 장기 실행 명령 제한 시간(초)을 지정합니다. 무기한 대기하려면 0을 사용합니다. |
| /p: | NoAlterStatementsToChangeClrTypes=(BOOLEAN) | 차이가 있을 경우 ALTER ASSEMBLY 문을 실행하는 대신 게시에서 항상 어셈블리를 삭제하고 다시 만들지를 지정합니다. |
| /p: | PerformIndexOperationsOnline=(BOOLEAN 'False') | 배포하는 동안 온라인으로 인덱스 작업을 수행할지 여부를 지정합니다. |
| /p: | PopulateFilesOnFileGroups=(BOOLEAN 'True') | 대상 데이터베이스에 새 FileGroup을 만들 때 새 파일도 생성되는지 여부를 지정합니다. |
| /p: | PreserveIdentityLastValues=(BOOLEAN 'False') | 배포하는 동안 ID 열의 마지막 값을 유지해야 하는지 여부를 지정합니다. |
| /p: | RegisterDataTierApplication=(BOOLEAN) | 스키마가 데이터베이스 서버에 등록되었는지 여부를 지정합니다. |
| /p: | RestoreSequenceCurrentValue=(BOOLEAN 'True') | 시퀀스 개체 현재 값을 dacpac 파일을 사용하여 배포해야 하는지 여부를 지정합니다. 기본값은 True입니다. |
| /p: | RunDeploymentPlanExecutors=(BOOLEAN) | 다른 작업이 실행될 때 DeploymentPlanExecutor 기여자를 실행할지 여부를 지정합니다. |
| /p: | ScriptDatabaseCollation=(BOOLEAN) | 데이터베이스에 게시할 때 데이터베이스 데이터 정렬의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | ScriptDatabaseCompatibility=(BOOLEAN) | 데이터베이스에 게시할 때 데이터베이스 호환성의 차이를 무시하거나 업데이트할지 여부를 지정합니다. |
| /p: | ScriptDatabaseOptions=(BOOLEAN 'True') | 게시 작업의 일부로 대상 데이터베이스 속성을 설정하거나 업데이트할지 여부를 지정합니다. |
| /p: | ScriptDeployStateChecks=(BOOLEAN) | 데이터베이스 이름 및 서버 이름이 데이터베이스 프로젝트에 지정된 이름과 일치하는지 확인하는 문을 게시 스크립트에 생성할지 여부를 지정합니다. |
| /p: | ScriptFileSize=(BOOLEAN) | 파일 그룹에 파일을 추가할 때 크기가 지정되는지 여부를 제어합니다. |
| /p: | ScriptNewConstraintValidation=(BOOLEAN 'True') | 게시 마지막에 모든 제약 조건은 하나의 집합으로 확인되므로 게시 중간에 검사 또는 외래 키 제약 조건으로 인한 데이터 오류가 발생하지 않습니다. False로 설정하면 해당 데이터를 확인하지 않고 제약 조건이 게시됩니다. |
| /p: | ScriptRefreshModule=(BOOLEAN 'True') | 게시 스크립트의 끝에 새로 고침 문을 포함합니다. |
| /p: | Storage=({File|Memory}) | 데이터베이스 모델을 빌드할 때 요소를 저장하는 방법을 지정합니다. 성능상의 이유로 기본값은 InMemory입니다. 대용량 데이터베이스의 경우 파일 지원 스토리지가 필요할 수 있으며 SqlPackage의 .NET Framework 버전에만 사용할 수 있습니다. |
| /p: | TreatVerificationErrorsAsWarnings=(BOOLEAN) | 게시 확인 중에 발생한 오류를 경고로 처리할지 여부를 지정합니다. 생성된 배포 계획을 대상 데이터베이스에 대해 실행하기 전에 해당 계획에 대한 확인이 수행됩니다. 계획 확인은 변경을 위해 삭제해야 하는 대상 전용 개체(예: 인덱스)의 손실과 같은 문제를 감지합니다. 또한 복합 프로젝트에 대한 참조로 인한 종속성(예: 테이블, 뷰)이 존재하지만 대상 데이터베이스에는 존재하지 않는 상황도 확인됩니다. 첫 번째 오류에서 게시 동작을 중지하는 대신 모든 문제의 전체 목록을 가져오려면 이 작업을 수행하도록 선택할 수 있습니다. |
| /p: | UnmodifiableObjectWarnings=(BOOLEAN 'True') | 개체에서 수정할 수 없는 차이가 발견될 경우(예: 파일 경로 또는 파일 크기가 특정 파일에서 다른 경우) 경고를 생성할지 여부를 지정합니다. |
| /p: | VerifyCollationCompatibility=(BOOLEAN 'True') | 데이터 정렬 호환성이 확인되는지 여부를 지정합니다. |
| /p: | VerifyDeployment=(BOOLEAN 'True') | 성공적인 게시를 차단할 수 있는 문제가 있는 경우 게시 작업을 중지하는 검사를 게시하기 전에 수행해야 하는지 여부를 지정합니다. 예를 들어 데이터베이스 프로젝트에 존재하지 않는 대상 데이터베이스에 외설 키가 있고 게시할 때 오류가 발생하는 경우 게시 작업이 중지될 수 있습니다. |
Next Steps
- SqlPackage에 대해 자세히 알아봅니다.