Limitazioni di denominazione Ciclo di vita di un RDS per SQL Server CEV

Creazione di una versione del motore personalizzata per RDS per SQL Server

Una versione del motore personalizzata (CEV) per RDS for SQL Server è costituita dai supporti di installazione di SQL Server Developer Edition importati in Amazon RDS. È necessario caricare il programma di installazione ISO di base e i file di aggiornamento cumulativo (.exe) nel bucket Amazon S3. Una volta caricato, devi fornire la posizione di Amazon S3 a RDS affinché possa scaricare, convalidare e successivamente creare il tuo CEV.

Limitazioni di denominazione

Quando si crea un CEV, è necessario seguire specifiche convenzioni di denominazione:

Il nome CEV deve seguire lo schema. major-version.minor-version.customized-string
customized-stringpuò contenere da 1 a 50 caratteri alfanumerici, trattini bassi, trattini e punti. Ad esempio: per SQL Server 202517.00.4045.5.my-dev-cev.

Per elencare tutte le versioni del motore supportate per Developer Edition (funzionalità Enterprise Edition), utilizzare il seguente AWS CLI comando:


aws rds describe-db-engine-versions --engine sqlserver-dev-ee --output json --query "{DBEngineVersions: DBEngineVersions[?Status=='requires-custom-engine-version'].{Engine: Engine, EngineVersion: EngineVersion, Status: Status, DBEngineDescription: DBEngineDescription, DBEngineVersionDescription: DBEngineVersionDescription}}"

{
    "DBEngineVersions": [
        {
            "Engine": "sqlserver-dev-ee",
            "EngineVersion": "17.00.4045.5.v1",
            "Status": "requires-custom-engine-version",
            "DBEngineDescription": "Microsoft SQL Server Enterprise Developer Edition",
            "DBEngineVersionDescription": "SQL Server 2025 17.00.4045.5.v1"
        }
    ]
}

Per elencare tutte le versioni del motore supportate per Developer Edition (funzionalità Standard Edition), usa il seguente AWS CLI comando:


aws rds describe-db-engine-versions --engine sqlserver-dev-se --output json --query "{DBEngineVersions: DBEngineVersions[?Status=='requires-custom-engine-version'].{Engine: Engine, EngineVersion: EngineVersion, Status: Status, DBEngineDescription: DBEngineDescription, DBEngineVersionDescription: DBEngineVersionDescription}}"

{
    "DBEngineVersions": [
        {
            "Engine": "sqlserver-dev-se",
            "EngineVersion": "17.00.4045.5.v1",
            "Status": "requires-custom-engine-version",
            "DBEngineDescription": "Microsoft SQL Server Standard Developer Edition",
            "DBEngineVersionDescription": "SQL Server 2025 17.00.4045.5.v1"
        }
    ]
}

Per creare una versione del motore personalizzata per Developer Edition (funzionalità Enterprise Edition)

Usa il comando create-custom-db-engine-version.

Sono richieste le seguenti opzioni:

--engine
--engine-version
--database-installation-files-s3-bucket-name
--database-installation-files
--region

È anche possibile specificare le seguenti opzioni:

--database-installation-files-s3-prefix
--description
--tags


aws rds create-custom-db-engine-version \
--engine sqlserver-dev-ee \
--engine-version 17.00.4045.5.cev-dev-ss2025-cu5 \
--region us-west-2 \
--database-installation-files-s3-bucket-name my-s3-installation-media-bucket \
--database-installation-files-s3-prefix sqlserver-dev-media \
--database-installation-files "SQLServer2025-x64-ENU-EntDev.iso" "SQLServer2025-KB5084896-x64.exe"

Per creare una versione del motore personalizzata per Developer Edition (funzionalità della Standard Edition)

Usa il comando create-custom-db-engine-version con. --engine sqlserver-dev-se


aws rds create-custom-db-engine-version \
--engine sqlserver-dev-se \
--engine-version 17.00.4045.5.cev-dev-se-ss2025-cu5 \
--region us-west-2 \
--database-installation-files-s3-bucket-name my-s3-installation-media-bucket \
--database-installation-files-s3-prefix sqlserver-dev-media \
--database-installation-files "SQLServer2025-x64-ENU-StdDev.iso" "SQLServer2025-KB5084896-x64.exe"

La creazione di un CEV richiede in genere 15-30 minuti. Per monitorare l'avanzamento della creazione del CEV, utilizzate il seguente comando:


# For Developer Edition (Enterprise Edition capabilities)
aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version 17.00.4045.5.my-dev-cev \
--region us-west-2

# For Developer Edition (Standard Edition capabilities)
aws rds describe-db-engine-versions \
--engine sqlserver-dev-se \
--engine-version 17.00.4045.5.my-dev-se-cev \
--region us-west-2

Ciclo di vita di un RDS per SQL Server CEV

Quando si utilizza SQL Server Developer Edition su RDS per SQL Server, le versioni personalizzate del motore passano attraverso vari stati del ciclo di vita.

Stato del ciclo di vita	Description	Quando si verifica	Operazioni disponibili
in attesa di convalida	Stato iniziale al momento della creazione del CEV	Questo è lo stato iniziale dopo la creazione con il `create-custom-db-engine-version` comando.	Monitora lo stato tramite`describe-db-engine-version`.
convalida	Stato di convalida CEV	Amazon RDS sta convalidando la tua versione personalizzata del motore (CEV). Il completamento di questo processo asincrono può richiedere del tempo.	Monitora lo stato fino al completamento della convalida.
disponibile	La convalida della versione del motore personalizzato (CEV) è stata completata con successo.	La versione Custom Engine (CEV) è ora disponibile. Amazon RDS ha convalidato con successo i file ISO e di aggiornamento cumulativo di SQL Server. Ora puoi creare istanze DB utilizzando questo CEV.	Crea istanze DB utilizzando questo CEV
Non riuscito	RDS per SQL Server non è in grado di creare la versione personalizzata del motore (CEV) perché il controllo di convalida non è riuscito.	La convalida ISO e cumulativa dei supporti non è riuscita.	Convalida ISO non riuscita. Controlla il motivo dell'errore`describe-db-engine-version`, correggi eventuali problemi relativi ai file, ad esempio errori di hash o contenuti danneggiati, quindi ricrea la versione personalizzata del motore (CEV).
deleting (eliminazione in corso)	La versione del motore personalizzato (CEV) è in fase di eliminazione	Dopo le chiamate del cliente `delete-custom-db-engine-version` fino al completamento del flusso di lavoro di eliminazione.	Monitora lo stato tramite. `describe-db-engine-version`
supporto di installazione incompatibile	Amazon RDS non è stato in grado di convalidare il supporto di installazione fornito per la versione personalizzata del motore (CEV)	La convalida della versione del motore personalizzato (CEV) non è riuscita. Si tratta di uno stato terminale.	Vedi FailureReason via `describe-db-engine-versions` per informazioni sul motivo per cui la convalida non è riuscita; elimina CEV.

Descrivi lo stato del CEV

Puoi vedere lo stato dei tuoi CEV usando: AWS CLI


aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version 17.00.4045.5.my-dev-cev \
--region us-west-2 \
--query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status}'

Per la Developer Edition (funzionalità della Standard Edition), sostituisci sqlserver-dev-ee con. sqlserver-dev-se

Output di esempio


| DescribeDBEngineVersions                          |
+------------+--------------------------------------+
| Status | Version                                  |
+------------+--------------------------------------+
| available | 17.00.4045.5.cev-dev-ss2025-cu5         |
+------------+--------------------------------------+

Quando un CEV mostra failed lo stato, puoi determinarne il motivo utilizzando il seguente comando:


aws rds describe-db-engine-versions \
--engine sqlserver-dev-ee \
--engine-version 17.00.4045.5.my-dev-cev \
--region us-west-2 \
--query 'DBEngineVersions[0].{Version:EngineVersion,Status:Status,FailureReason:FailureReason}'

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Preparazione di una CEV

Creazione di un'istanza DB Developer Edition