SqlPackage 배포 보고서 및 드리프트 보고서
SqlPackage DeployReport 작업은 게시 작업으로 변경된 항목의 XML 보고서를 만듭니다. SqlPackage DriftReport 작업은 마지막으로 등록된 후에 등록된 데이터베이스에 변경된 항목의 XML 보고서를 만듭니다.
참고 항목
Microsoft Entra ID 는 이전에 Azure AD(Azure Active Directory)라고 했습니다.
명령줄 구문
SqlPackage는 명령줄에 지정된 매개 변수, 속성 및 SQLCMD 변수를 사용하여 지정된 작업을 시작합니다.
SqlPackage {parameters}{properties}{SQLCMD Variables}
DeployReport 작업 매개 변수
| 매개 변수 | 약식 | 값 | 설명 |
|---|---|---|---|
| /Action: | /a: | DeployReport | 수행할 작업을 지정합니다. |
| /AccessToken: | /에: | {string} | 대상 데이터베이스에 연결할 때 사용할 액세스 토큰 기반 인증 액세스 토큰을 지정합니다. |
| /Diagnostics: | /D: | {True|False} | 진단 로깅이 콘솔로 출력되는지 여부를 지정합니다. 기본값은 False입니다. |
| /DiagnosticsFile: | /Df: | {string} | 진단 로그를 저장할 파일을 지정합니다. |
| /MaxParallelism: | /Mp: | {int} | 데이터베이스에 대해 실행 중인 동시 작업에 대한 병렬 처리 수준을 지정합니다. 기본값은 8입니다. |
| /OutputPath: | /Op: | {string} | 출력 파일이 생성되는 파일 경로를 지정합니다. |
| /OverwriteFiles: | /의: | {True|False} | SqlPackage가 기존 파일을 덮어써야 할지 여부를 지정합니다. False를 지정하면 기존 파일이 나타나는 경우 SqlPackage에서 작업이 중단됩니다. 기본값은 True입니다. |
| /Profile: | /홍보: | {string} | DAC 게시 프로필에 대한 파일 경로를 지정합니다. 프로필은 출력을 생성할 때 사용할 속성 및 변수 컬렉션을 정의합니다. |
| /Properties: | /p: | {PropertyName}={Value} | 작업별 속성에 대한 이름 값 쌍을 지정합니다. {PropertyName}={Value}. |
| /Quiet: | /Q: | {True|False} | 자세한 피드백을 무시할지 여부를 지정합니다. 기본값은 False입니다. |
| /SourceFile: | /Sf: | {string} | 데이터베이스 대신 작업 원본으로 사용할 원본 파일을 지정합니다. 이 매개 변수를 사용하는 경우 다른 원본 매개 변수가 무효화됩니다. |
| /SourceConnectionString: | /Scs: | {string} | 원본 데이터베이스에 대한 유효한 SQL Server/Azure 연결 문자열을 지정합니다. 이 매개 변수를 지정한 경우 다른 모든 원본 매개 변수와 단독으로 연결 문자열이 사용됩니다. |
| /SourceDatabaseName: | /Sdn: | {string} | 원본 데이터베이스의 이름을 정의합니다. |
| /SourceEncryptConnection: | /초: | {Optional|Mandatory|Strict|True|False} | 원본 데이터베이스 연결에 대해 SQL 암호화를 사용할지 여부를 지정합니다. 기본값은 True입니다. |
| /SourceHostNameInCertificate: | /shnic: | {string} | TLS를 사용하여 통신 계층을 암호화할 때 원본 SQL Server TLS/SSL 인증서의 유효성을 검사하는 데 사용되는 값을 지정합니다. |
| /SourcePassword: | /Sp: | {string} | SQL Server 인증 시나리오에서 원본 데이터베이스에 액세스하는 데 사용할 암호를 정의합니다. |
| /SourceServerName: | /Ssn: | {string} | 원본 데이터베이스를 호스팅하는 서버의 이름을 정의합니다. |
| /SourceTimeout: | /세인트: | {int} | 원본 데이터베이스에 대한 연결을 설정하는 데 대한 제한 시간(초)을 지정합니다. |
| /SourceTrustServerCertificate: | /stsc: | {True|False} | 원본 데이터베이스 연결을 암호화하고 신뢰의 유효성을 검증하기 위한 인증서 체인 검색을 건너뛰는 데 TLS를 사용할지 여부를 지정합니다. 기본값은 False입니다. |
| /SourceUser: | /수호: | {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 또는 do기본 이름을 나타냅니다. 이 옵션은 게스트 또는 가져온 Microsoft Entra 사용자뿐만 아니라 outlook.com, hotmail.com 또는 live.com 같은 Microsoft 계정을 지원하는 데 필요합니다. 이 매개 변수를 생략하면 인증된 사용자가 이 테넌트의 네이티브 사용자라고 가정하면 Microsoft Entra ID의 기본 테넌트 ID가 사용됩니다. 그러나 이 경우 이 Microsoft Entra ID에 호스트된 게스트 또는 가져온 사용자 및/또는 Microsoft 계정은 지원되지 않으며 작업이 실패합니다. 자세한 내용은 SQL Database 및 Azure Synapse Analytics(MFA에 대한 SSMS 지원)를 사용한 유니버설 인증을 참조하세요. |
| /UniversalAuthentication: | /Ua: | {True|False} | 범용 인증을 사용해야 하는지를 지정합니다. True로 설정되면 대화형 인증 프로토콜이 MFA를 지원하도록 활성화됩니다. 이 옵션은 사용자가 사용자 이름 및 암호 또는 통합 인증(Windows 자격 증명)을 입력하도록 요구하는 대화형 프로토콜을 사용하여 MFA 없이 Microsoft Entra 인증에 사용할 수도 있습니다. /UniversalAuthentication이 True로 설정된 경우 Source커넥트ionString(/scs)에서 Microsoft Entra 인증을 지정할 수 없습니다. /UniversalAuthentication이 False로 설정되면 Source커넥트ionString(/scs)에서 Microsoft Entra 인증을 지정해야 합니다. 자세한 내용은 SQL Database 및 Azure Synapse Analytics(MFA에 대한 SSMS 지원)를 사용한 유니버설 인증을 참조하세요. |
| /Variables: | /V: | {PropertyName}={Value} | 작업별 변수에 대한 이름 값 쌍을 지정합니다. {VariableName}={Value}. DACPAC 파일에는 유효한 SQLCMD 변수 목록이 포함됩니다. 모든 변수에 대해 값을 제공하지 않으면 오류가 발생합니다. |
DeployReport 작업 속성
| 속성 | 값 | Description |
|---|---|---|
| /p: | AdditionalDeploymentContributorArguments=(STRING) | 배포 참가자에 대한 추가 배포 참가자 인수를 지정합니다. 세미콜론으로 구분된 값의 목록이어야 합니다. |
| /p: | AdditionalDeploymentContributors=(STRING) | dacpac가 배포될 때 실행되어야 하는 추가 배포 기여자를 지정합니다. 세미콜론으로 구분된 정규화된 빌드 참가자 이름 또는 ID의 목록이어야 합니다. |
| /p: | AdditionalDeploymentContributorPaths=(STRING) | 추가 배포 참가자를 로드할 경로를 지정합니다. 세미콜론으로 구분된 값의 목록이어야 합니다. |
| /p: | AllowDropBlocking Assemblies=(BOOLEAN) | 이 속성은 SqlClr 배포에서 배포 계획의 일부로 차단 어셈블리를 삭제하는 데 사용됩니다. 기본적으로 어셈블리를 삭제해야 하는 경우에는 모든 차단/참조 어셈블리가 어셈블리 업데이트를 차단합니다. |
| /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 | Standard | Premium | DataWarehouse | GeneralPurpose | BusinessCritical | Hyperscale | Default } 'Default') | 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, AsymmetricKeys, BrokerPriorities, Certificates, ColumnEncryptionKeys, ColumnMasterKeys, Contracts, DatabaseRoles, DatabaseTriggers, Defaults, ExtendedProperties, ExternalDataSources, ExternalFileFormats, ExternalTables, Filegroups, 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, XmlSchemaCollections, Audits, Credentials, CryptographicProviders, DatabaseAuditSpecifications, DatabaseScopedCredentials, Endpoints, ErrorMessages, EventNotifications, EventSessions, LinkedServerLogins, LinkedServers, Logins, Routes, ServerAuditSpecifications, ServerRoleMembership, ServerRoles, ServerTriggers입니다. 이 속성은 여러 옵션을 나타내기 위해 여러 번 지정할 수 있습니다. |
| /p: | DoNotDropObjectTypes=(STRING) | DropObjectsNotInSource가 true인 경우 삭제하지 않아야 하는 개체 형식을 세미콜론으로 구분한 목록입니다. 유효한 개체 유형 이름은 Aggregates, ApplicationRoles, Assemblies, AsymmetricKeys, BrokerPriorities, Certificates, ColumnEncryptionKeys, ColumnMasterKeys, Contracts, DatabaseRoles, DatabaseTriggers, Defaults, ExtendedProperties, ExternalDataSources, ExternalFileFormats, ExternalTables, Filegroups, 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, XmlSchemaCollections, Audits, Credentials, CryptographicProviders, DatabaseAuditSpecifications, DatabaseScopedCredentials, Endpoints, ErrorMessages, EventNotifications, EventSessions, LinkedServerLogins, LinkedServers, Logins, Routes, ServerAuditSpecifications, ServerRoleMembership, ServerRoles, ServerTriggers입니다. |
| /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: | ExcludeObjectType=(STRING) | 배포 중에 무시되어야 하는 개체 유형입니다. 유효한 개체 유형 이름은 Aggregates, ApplicationRoles, Assemblies, AsymmetricKeys, BrokerPriorities, Certificates, ColumnEncryptionKeys, ColumnMasterKeys, Contracts, DatabaseRoles, DatabaseTriggers, Defaults, ExtendedProperties, ExternalDataSources, ExternalFileFormats, ExternalTables, Filegroups, 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, XmlSchemaCollections, Audits, Credentials, CryptographicProviders, DatabaseAuditSpecifications, DatabaseScopedCredentials, Endpoints, ErrorMessages, EventNotifications, EventSessions, LinkedServerLogins, LinkedServers, Logins, Routes, ServerAuditSpecifications, ServerRoleMembership, ServerRoles, ServerTriggers입니다. |
| /p: | ExcludeObjectTypes=(STRING) | 배포 중에 무시되어야 하는 개체 유형의 세미콜론으로 구분된 목록입니다. 유효한 개체 유형 이름은 Aggregates, ApplicationRoles, Assemblies, AsymmetricKeys, BrokerPriorities, Certificates, ColumnEncryptionKeys, ColumnMasterKeys, Contracts, DatabaseRoles, DatabaseTriggers, Defaults, ExtendedProperties, ExternalDataSources, ExternalFileFormats, ExternalTables, Filegroups, 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, XmlSchemaCollections, Audits, Credentials, CryptographicProviders, DatabaseAuditSpecifications, DatabaseScopedCredentials, Endpoints, ErrorMessages, EventNotifications, EventSessions, LinkedServerLogins, LinkedServers, Logins, Routes, ServerAuditSpecifications, ServerRoleMembership, ServerRoles, ServerTriggers입니다. |
| /p: | GenerateSmartDefaults=(BOOLEAN) | 데이터가 들어 있는 테이블을 Null 값을 허용하지 않는 열로 업데이트할 때 자동으로 기본 값을 제공합니다. |
| /p: | IgnoreAnsiNulls=(BOOLEAN 'True') | 데이터베이스에 게시할 때 ANSI NULLS 설정에 대한 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreAuthorizer=(BOOLEAN) | 데이터베이스에 게시할 때 권한 부여자를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreColumnCollation=(BOOLEAN) | 데이터베이스에 게시할 때 열 데이터 정렬의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreColumnOrder=(BOOLEAN) | 데이터베이스에 게시할 때 테이블 열 순서의 차이를 무시해야 할지 아니면 업데이트해야 할지를 지정합니다. |
| /p: | IgnoreComments=(BOOLEAN) | 데이터베이스에 게시할 때 주석의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreCryptographicProviderFilePath=(BOOLEAN 'True') | 데이터베이스에 게시할 때 암호화 공급자에 대한 파일 경로의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreDdlTriggerOrder=(BOOLEAN) | 데이터베이스 또는 서버에 게시할 때 DDL(Data Definition Language) 트리거 순서의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreDdlTriggerState=(BOOLEAN) | 데이터베이스에 게시할 때 DDL(Data Definition Language) 트리거 사용/사용 안 함 상태의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreDefaultSchema=(BOOLEAN) | 데이터베이스에 게시할 때 기본 스키마의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreDmlTriggerOrder=(BOOLEAN) | 데이터베이스에 게시할 때 DML(Data Manipulation Language) 트리거 순서의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /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: | IgnoreQuotedIdentifiers=(BOOLEAN 'True') | 데이터베이스에 게시할 때 따옴표 붙은 식별자 설정의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreRoleMembership=(BOOLEAN) | 데이터베이스에 게시할 때 로그인의 역할 멤버 자격 차이를 무시 또는 업데이트할지 여부를 지정합니다. |
| /p: | IgnoreRouteLifetime=(BOOLEAN 'True') | 데이터베이스에 게시할 때 SQL Server가 라우팅 테이블에 경로를 유지하는 시간에 대한 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /p: | IgnoreSemicolonBetweenStatements=(BOOLEAN 'True') | 데이터베이스에 게시할 때 T-SQL 문 사이의 세미콜론의 차이를 무시할지 또는 업데이트할지를 지정합니다. |
| /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: | IncludeCompositeObjects=(BOOLEAN) | 단일 게시 작업의 일부로 동일한 데이터베이스를 가진 모든 복합 요소를 포함합니다. |
| /p: | IncludeTransactionalScripts=(BOOLEAN) | 데이터베이스에 게시할 때 가능한 위치에 트랜잭션 문을 사용할지 여부를 지정합니다. |
| /p: | LongRunningCommandTimeout=(INT32 '0') | SQL Server에 대한 쿼리를 실행할 때 장기 명령 시간 제한(초)을 지정합니다. 무기한 대기하려면 0을 사용합니다. |
| /p: | NoAlterStatementsToChangeClrTypes=(BOOLEAN) | 차이가 있을 경우 ALTER ASSEMBLY 문을 실행하는 대신 게시에서 항상 어셈블리를 삭제하고 다시 만들지를 지정합니다. |
| /p: | PerformIndexOperationsOnline=(BOOLEAN 'False') | 배포하는 동안 온라인으로 인덱스 작업을 수행할지 여부를 지정합니다. |
| /p: | PopulateFilesOnFileGroups=(BOOLEAN 'True') | 대상 데이터베이스에 새 FileGroup이 만들어질 때 새 파일도 만들어지는지 여부를 지정합니다. |
| /p: | RegisterDataTierApplication=(BOOLEAN) | 스키마가 데이터베이스 서버에 등록되었는지 여부를 지정합니다. |
| /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입니다. 대용량 데이터베이스의 경우 파일 지원 스토리지가 필요할 수 있으며 .NET Framework 버전의 SqlPackage에만 사용할 수 있습니다. |
| /p: | TreatVerificationErrorsAsWarnings=(BOOLEAN) | 확인을 경고로 처리해야 하는 동안 발생한 오류를 게시하는지 여부를 지정합니다. 생성된 배포 계획을 대상 데이터베이스에 대해 실행하기 전에 해당 계획에 대한 확인이 수행됩니다. 계획 확인에서 대상 전용 개체(예: 인덱스)가 없는 등의 문제가 발견되면 해당 계획을 삭제하여 변경해야 합니다. 또한 복합 프로젝트에 대한 참조로 인한 종속성(예: 테이블, 뷰)이 존재하지만 대상 데이터베이스에는 존재하지 않는 상황도 확인됩니다. 첫 번째 오류에서 게시 동작을 중지하는 대신 모든 문제의 전체 목록을 가져오려면 이 작업을 수행하도록 선택할 수 있습니다. |
| /p: | UnmodifiableObjectWarnings=(BOOLEAN 'True') | 개체에서 수정할 수 없는 차이가 발견될 경우(예: 파일 경로 또는 파일 크기가 특정 파일에서 다른 경우) 경고를 생성할지 여부를 지정합니다. |
| /p: | VerifyCollationCompatibility=(BOOLEAN 'True') | 데이터 정렬 호환성이 확인되는지 여부를 지정합니다. |
| /p: | VerifyDeployment=(BOOLEAN 'True') | 성공적인 게시를 차단할 수 있는 문제가 존재할 경우 게시 작업을 중단하는 검사를 게시 전에 수행할지 여부를 지정합니다. 예를 들어 데이터베이스 프로젝트에 존재하지 않고 게시할 때 오류를 일으키는 외래 키를 대상 데이터베이스에 설정한 경우 게시 작업이 중단될 수 있습니다. |
DriftReport 작업 매개 변수
| 매개 변수 | 약식 | 값 | 설명 |
|---|---|---|---|
| /Action: | /a: | DriftReport | 수행할 작업을 지정합니다. |
| /AccessToken: | /에: | {string} | 대상 데이터베이스에 연결할 때 사용할 액세스 토큰 기반 인증 액세스 토큰을 지정합니다. |
| /Diagnostics: | /D: | {True|False} | 진단 로깅이 콘솔로 출력되는지 여부를 지정합니다. 기본값은 False입니다. |
| /DiagnosticsFile: | /Df: | {string} | 진단 로그를 저장할 파일을 지정합니다. |
| /MaxParallelism: | /Mp: | {int} | 데이터베이스에 대해 실행 중인 동시 작업에 대한 병렬 처리 수준을 지정합니다. 기본값은 8입니다. |
| /OutputPath: | /Op: | {string} | 출력 파일이 생성되는 파일 경로를 지정합니다. |
| /OverwriteFiles: | /의: | {True|False} | SqlPackage가 기존 파일을 덮어써야 할지 여부를 지정합니다. False를 지정하면 기존 파일이 나타나는 경우 SqlPackage에서 작업이 중단됩니다. 기본값은 True입니다. |
| /Quiet: | /Q: | {True|False} | 자세한 피드백을 무시할지 여부를 지정합니다. 기본값은 False입니다. |
| /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 또는 do기본 이름을 나타냅니다. 이 옵션은 게스트 또는 가져온 Microsoft Entra 사용자뿐만 아니라 outlook.com, hotmail.com 또는 live.com 같은 Microsoft 계정을 지원하는 데 필요합니다. 이 매개 변수를 생략하면 인증된 사용자가 이 테넌트의 네이티브 사용자라고 가정하면 Microsoft Entra ID의 기본 테넌트 ID가 사용됩니다. 그러나 이 경우 이 Microsoft Entra ID에 호스트된 게스트 또는 가져온 사용자 및/또는 Microsoft 계정은 지원되지 않으며 작업이 실패합니다. 자세한 내용은 SQL Database 및 Azure Synapse Analytics(MFA에 대한 SSMS 지원)를 사용한 유니버설 인증을 참조하세요. |
| /UniversalAuthentication: | /Ua: | {True|False} | 범용 인증을 사용해야 하는지를 지정합니다. True로 설정되면 대화형 인증 프로토콜이 MFA를 지원하도록 활성화됩니다. 이 옵션은 사용자가 사용자 이름 및 암호 또는 통합 인증(Windows 자격 증명)을 입력하도록 요구하는 대화형 프로토콜을 사용하여 MFA 없이 Microsoft Entra 인증에 사용할 수도 있습니다. /UniversalAuthentication이 True로 설정된 경우 Source커넥트ionString(/scs)에서 Microsoft Entra 인증을 지정할 수 없습니다. /UniversalAuthentication이 False로 설정되면 Source커넥트ionString(/scs)에서 Microsoft Entra 인증을 지정해야 합니다. 자세한 내용은 SQL Database 및 Azure Synapse Analytics(MFA에 대한 SSMS 지원)를 사용한 유니버설 인증을 참조하세요. |
다음 단계
- SqlPackage에 대해 자세히 알아봅니다.