

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione e gestione delle versioni del motore BYOM per RDS per SQL Server
<a name="sqlserver-byom-creating-cev"></a>

La creazione di una versione del motore BYOM richiede una sola configurazione (verifica della mobilità delle licenze, ottenimento di contenuti multimediali RTM e caricamento su S3). Dopo la configurazione, puoi creare versioni del motore utilizzando la console Amazon RDS o la AWS CLI.

## Prima di iniziare
<a name="sqlserver-byom-creating-cev.before-you-begin"></a>

### Passaggio 1: completare la verifica di Microsoft License Mobility
<a name="sqlserver-byom-creating-cev.step1"></a>

Per il BYOM è richiesta la mobilità delle licenze tramite Software Assurance. È necessario disporre di una copertura Software Assurance attiva sulle licenze di SQL Server prima di distribuirle. AWS

Per completare il processo di verifica:

1. **Verifica dell'idoneità** Visita la [pagina AWS License Mobility](https://aws.amazon.com/windows/resources/licensemobility/) per esaminare i requisiti e i criteri di idoneità.

1. **Invia il modulo di verifica** Scarica e completa il [modulo di verifica Microsoft License Mobility](https://www.microsoft.com/en-us/licensing/licensing-programs/software-assurance-license-mobility.aspx). Invia il modulo a Microsoft tramite il tuo partner di licenza o direttamente.

1. **Attendi l'approvazione** Microsoft ti invia un'email di conferma quando la verifica viene approvata.

È necessario inviare il modulo a Microsoft direttamente o tramite il rivenditore Microsoft entro 10 giorni dalla consegna dei prodotti. AWS

**Importante**  
AWS non convalida o impone la conformità delle licenze Microsoft. L'utente è responsabile del mantenimento della conformità ai contratti di licenza Microsoft.

### Passaggio 2: Ottenere i supporti di installazione di SQL Server
<a name="sqlserver-byom-creating-cev.step2"></a>

Scarica il file Release to Manufacturing (RTM) per la versione principale di SQL Server che desideri utilizzare. Il file RTM è il supporto di installazione di base per una versione e un'edizione principali di SQL Server (ad esempio, SQL Server 2019 Enterprise Edition).

È possibile ottenere il file RTM da una delle seguenti fonti Microsoft:
+ **Abbonamento a Visual Studio** Se hai un abbonamento attivo a Visual Studio, scarica il file RTM dalla pagina dei download per [abbonati](https://visualstudio.microsoft.com/subscriptions/).
+ Interfaccia di **amministrazione Microsoft 365** Se hai acquistato prodotti tramite contratti multilicenza, scarica il file RTM dalla pagina dei [download dell'interfaccia di amministrazione di Microsoft 365](https://admin.microsoft.com).

**Importante**  
Scarica solo il file Core-based ISO in lingua inglese. Non utilizzare il file CAL-based ISO Server\+.

### Fase 3: Caricare i supporti di installazione su Amazon S3
<a name="sqlserver-byom-creating-cev.step3"></a>

Carica il file SQL Server RTM in un bucket Amazon S3 nella AWS stessa regione e nello stesso account in cui intendi creare la versione del motore BYOM. Per caricare il file RTM utilizzando la AWS CLI:

```
aws s3 cp SQLServer2022-x64-ENU-Enterprise.iso s3://my-sqlserver-media/ISOs/
```

**Nota**  
Se non fornisci un file di aggiornamento cumulativo (CU) durante la creazione del motore BYOM, Amazon RDS scarica automaticamente la CU richiesta da Microsoft quando crei la versione del motore.

## Creazione di una versione del motore BYOM
<a name="sqlserver-byom-creating-cev.creating"></a>

Utilizzato `describe-db-engine-versions` per verificare quali versioni del motore sono idonee per la creazione di una versione del motore BYOM. Per le versioni supportate, consulta. [Bring Your Own Media (BYOM) per RDS per SQL Server](sqlserver-byom.md)

### Console
<a name="sqlserver-byom-creating-cev.console"></a>

1. Accedi alla [console di AWS gestione](https://console.aws.amazon.com/rds/) e apri la console Amazon RDS.

1. Nel pannello di navigazione, scegliere **Versioni motore personalizzate**.

1. Dal menu a discesa, seleziona **RDS per SQL Server**.

1. Scegliere **Creazione della versione del motore personalizzata**.

1. Per **Tipo di motore**, scegli **SQL Server**.

1. In **Tipo di gestione del database**, selezionare **Amazon RDS**.

1. Per **Edition**, scegli una delle seguenti opzioni: 
   + SQL Server Enterprise Edition
   + SQL Server Standard Edition

1. Per la **versione Engine**, scegli la versione di SQL Server che corrisponde ai tuoi file di installazione (ad esempio, SQL Server 2022`16.00.4175.1.v1`).

1. Per **i supporti di installazione**, inserisci l'URI S3 che contiene i file multimediali RTM di SQL Server oppure scegli **Sfoglia S3** per individuare e selezionare il file.

1. Scegliere **Creazione della versione del motore personalizzata**.

**La console mostra la nuova versione del motore BYOM con lo stato iniziale di Convalida in sospeso.** Lo stato avanza automaticamente. Per ulteriori informazioni, consulta [Stati del ciclo di vita della versione del motore BYOM](#sqlserver-byom-creating-cev.lifecycle).

### CLI
<a name="sqlserver-byom-creating-cev.cli"></a>

Utilizzate il `create-custom-db-engine-version` comando per creare una versione del motore BYOM dal supporto di installazione. Amazon RDS scarica automaticamente l'aggiornamento cumulativo richiesto da Microsoft.

```
aws rds create-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --database-installation-files-s3-bucket-name my-sqlserver-media \
    --database-installation-files-s3-prefix "ISOs/" \
    --database-installation-files "SQLServer2022-x64-ENU-Enterprise.iso"
```

**Risposta**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    "DatabaseInstallationFiles": [
        "SQLServer2022-x64-ENU-Enterprise.iso"
    ],
    "DBEngineDescription": "Microsoft SQL Server Enterprise Edition",
    "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:sqlserver-ee/16.00.4175.1.v1/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
    ....
    "Status": "pending-validation",
    .....
}
```

**Parametri CLI**


| Parametro | Obbligatorio | Descrizione | 
| --- | --- | --- | 
| --engine | Sì | Il tipo di motore di database:sqlserver-ee,sqlserver-se. | 
| --engine-version | Sì | La versione del motore di destinazione (ad esempio,16.00.4175.1.v1). | 
| --database-installation-files-s3-bucket-name | Sì | Il nome del bucket S3 che contiene il supporto di installazione. Il bucket deve trovarsi nella stessa AWS regione della versione del motore BYOM. | 
| --database-installation-files-s3-prefix | No | Il prefisso del tasto S3 (percorso della cartella) in cui sono archiviati i file multimediali di installazione. | 
| --database-installation-files | Sì | I nomi dei file del supporto di installazione. | 

**Nota**  
Quando si utilizza la AWS CLI, i `--database-installation-files` parametri `--database-installation-files-s3-bucket-name``--database-installation-files-s3-prefix`, e sono necessari solo per la prima versione del motore BYOM creata per una versione e un'edizione principali. Solo `--engine` per le versioni secondarie successive all'interno della stessa versione principale, sono obbligatorie. `--engine-version`

## Descrizione delle versioni del motore BYOM
<a name="sqlserver-byom-creating-cev.describing"></a>

Dopo aver creato una versione del motore BYOM, utilizzala `describe-db-engine-versions` per controllarne lo stato e i dettagli. L'output restituisce due record per la stessa versione del motore: uno per License Included (`DBEngineMediaType: None`) e uno per BYOM (). `DBEngineMediaType: Customer Provided`

**Esempio**:

```
aws rds describe-db-engine-versions \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --include-all \
    --output table \
    --query "DBEngineVersions[].{Engine: Engine, Version: EngineVersion, Status: Status, MediaType: DBEngineMediaType}"
```

**Risposta:**

```
-----------------------------------------------------------------------
|                      DescribeDBEngineVersions                       |
+--------------+---------------------+------------+-------------------+
|    Engine    |      MediaType      |  Status    |      Version      |
+--------------+---------------------+------------+-------------------+
|  sqlserver-ee|  None               |  available |  16.00.4175.1.v1  |
|  sqlserver-ee|  Customer Provided  |  available |  16.00.4175.1.v1  |
+--------------+---------------------+------------+-------------------+
```

## Stati del ciclo di vita della versione del motore BYOM
<a name="sqlserver-byom-creating-cev.lifecycle"></a>


| Stato | Description | 
| --- | --- | 
| pending-validation | RDS ha accettato la richiesta e l'ha messa in coda per l'elaborazione. | 
| validating | RDS sta convalidando il file multimediale RTM. | 
| creating | RDS sta installando SQL Server dal file multimediale RTM. | 
| available | La versione del motore BYOM è pronta per la creazione dell'istanza. | 
| incompatible\_installation\_media | I file di installazione non sono validi o sono danneggiati. Si tratta di uno stato terminale. Eliminare la versione del motore BYOM e riprovare con i file corretti. | 

## Modifica di una versione del motore BYOM
<a name="sqlserver-byom-creating-cev.modifying"></a>

È possibile modificare una versione del motore BYOM utilizzando la console di AWS gestione o la CLI AWS . È possibile modificare la descrizione della versione del motore BYOM o il relativo stato di disponibilità. La versione del motore BYOM ha uno dei seguenti valori di stato:
+ **disponibile**: è possibile utilizzare questa versione del motore BYOM per creare una nuova istanza DB o aggiornare un'istanza DB. Questo è lo stato predefinito per una versione del motore BYOM appena creata.
+ **inattivo**: non è possibile creare o aggiornare un'istanza DB con questa versione del motore BYOM. Non è possibile ripristinare uno snapshot DB per creare una nuova istanza DB con questa versione del motore BYOM.

È possibile modificare lo stato della versione del motore BYOM da `available` o a. `inactive` `inactive` `available` È possibile modificare lo stato `inactive` per impedire l'uso accidentale di una versione del motore BYOM o per rendere nuovamente idonea all'uso una versione del motore BYOM fuori produzione.

```
aws rds modify-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1 \
    --status inactive
```

**Risposta**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    ....
    "Status": "inactive",
    ....
}
```

**Nota**  
Le istanze esistenti in esecuzione su una versione del motore BYOM impostata come inattiva continuano a funzionare normalmente. Sono interessate solo le operazioni di creazione e ripristino di nuove istanze.

## Eliminazione di una versione del motore BYOM
<a name="sqlserver-byom-creating-cev.deleting"></a>

Consente `delete-custom-db-engine-version` di rimuovere definitivamente una versione del motore BYOM. Dopo l'eliminazione, la versione del motore torna a essere inserita in un'unica LI-only voce.

**Prerequisiti per l'eliminazione**

Prima di eliminare una versione del motore BYOM, verificate quanto segue:
+ Nessuna istanza DB utilizza la versione BYOM.
+ Nessuna istantanea DB fa riferimento alla versione BYOM.

Se esiste una qualsiasi delle risorse RDS, l'API non riesce a completare la richiesta di eliminazione.

**Eliminazione di una versione del motore BYOM (CLI)**

```
aws rds delete-custom-db-engine-version \
    --engine sqlserver-ee \
    --engine-version 16.00.4175.1.v1
```

**Risposta**

```
{
    "Engine": "sqlserver-ee",
    "MajorEngineVersion": "16.00",
    "EngineVersion": "16.00.4175.1.v1",
    .....
    "Status": "deleting",
    ....
}
```

## Considerazioni
<a name="sqlserver-byom-creating-cev.considerations"></a>
+ Il file ISO RTM viene fornito una volta per versione ed edizione principali. Tutte le versioni secondarie all'interno della stessa versione ed edizione principali riutilizzeranno gli stessi supporti di installazione.
+ Quando si fornisce SQL Server RTM per Bring Your Own Media, è necessario utilizzare solo l'ISO Core-based RTM e non il file ISO RTM basato su Server \+ CAL.

## Fasi successive
<a name="sqlserver-byom-creating-cev.next-steps"></a>

Una volta raggiunto `available` lo stato della versione del motore BYOM, è possibile avviare un'istanza di RDS for SQL Server utilizzandola. Per informazioni, consulta [Creazione di un'istanza DB BYOM per RDS per SQL Server](sqlserver-byom-creating-instance.md).