

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Versión 1.2.0.2 del motor de Amazon Neptune (20/11/2022)
<a name="engine-releases-1.2.0.2"></a>

A partir del 20 de noviembre de 2022, se implementará de forma general la versión 1.2.0.2 del motor. Tenga en cuenta que las versiones nuevas tardan unos días en estar disponibles en todas las regiones.

**nota**  
**Si se realiza la actualización desde una versión del motor anterior a la 1.2.0.0:**  
En la [versión 1.2.0.0 del motor](engine-releases-1.2.0.0.md), se introdujo un nuevo formato para los grupos de parámetros personalizados y los grupos de parámetros de clústeres personalizados. En consecuencia, si va a actualizar una versión de motor anterior a la 1.2.0.0 a una versión de motor 1.2.0.0 o posterior, debe volver a crear todos los grupos de parámetros personalizados y los grupos de parámetros de clúster personalizados existentes utilizando la familia de grupos de parámetros `neptune1.2`. En las versiones anteriores, se utilizaba la familia de grupos de parámetros `neptune1`, y esos grupos de parámetros no funcionan con la versión 1.2.0.0 y las versiones posteriores. Para obtener más información, consulte [Grupos de parámetros de Amazon Neptune](parameter-groups.md).
En la versión 1.2.0.0 del motor, también se introdujo un nuevo formato para los registros de deshacer. Como resultado, se deben purgar todos los registros de deshacer que se hayan creado con una versión anterior del motor y la métrica [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) de CloudWatch debe ser cero antes de que se pueda iniciar una actualización desde una versión anterior a la 1.2.0.0. Si hay demasiados registros de deshacer (200 000 o más), al intentar iniciar una actualización, es posible que se agote el tiempo de espera de la purga de los registros de deshacer.  
Para acelerar la velocidad de depuración, actualice la instancia del escritor del clúster, que es donde se realiza la depuración. Si lo hace antes de intentar la actualización, puede reducir el número de registros de deshacer antes de empezar. Si se aumenta el tamaño del escritor a un tipo de instancia 24XL, se puede aumentar la velocidad de purga a más de un millón de registros por hora.  
Si la métrica `UndoLogsListSize` de CloudWatch es muy grande, abra un caso de soporte para ayudarle a analizar estrategias adicionales para reducirla.
Por último, se ha producido un cambio importante en la versión 1.2.0.0 que afecta al código anterior que utilizaba el protocolo Bolt con autenticación de IAM. A partir de la versión 1.2.0.0, Bolt necesita una ruta de recursos para la firma de IAM. En Java, la ruta del recurso podría tener este aspecto: `request.setResourcePath("/openCypher"));`. En otros lenguajes, `/openCypher` se puede agregar al URI del punto de conexión. Para ver ejemplos, consulte [Uso del protocolo Bolt](access-graph-opencypher-bolt.md).

## Versiones de parche posteriores para esta versión
<a name="engine-releases-1.2.0.2-patches"></a>
+ [Versión: 1.2.0.2.R2 (15/12/2022)](engine-releases-1.2.0.2.R2.md) 
+ [Versión: 1.2.0.2.R3 (27/03/2023)](engine-releases-1.2.0.2.R3.md) 
+ [Versión: 1.2.0.2.R4 (08/05/2023)](engine-releases-1.2.0.2.R4.md) 
+ [Versión: 1.2.0.2.R5 (16/08/2023)](engine-releases-1.2.0.2.R5.md) 
+ [Versión: 1.2.0.2.R6 (12/09/2023)](engine-releases-1.2.0.2.R6.md) 

## Nuevas características de esta versión del motor
<a name="engine-releases-1.2.0.2-features"></a>
+ Se ha introducido la [inferencia inductiva en tiempo real](machine-learning-overview-evolving-data.md#inductive-vs-transductive-inference) para Gremlin en Neptune ML.
+ Se ha introducido una extensión de openCypher que permite especificar [valores de ID personalizados para las entidades](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids) en lugar de los UUID que Neptune genera. La posibilidad de asignar identificadores personalizados facilita la migración a Neptune desde Neo4j.
**aviso**  
Esta extensión de la especificación de openCypher no es compatible con versiones anteriores, ya que ahora `~id` se considera un nombre de propiedad reservada. Si ya utiliza `~id` como propiedad en sus datos y consultas, debe [migrar la propiedad `~id` a una nueva clave de propiedad](access-graph-opencypher-extensions.md#opencypher-compliance-custom-ids-migrating) antes de actualizar a esta versión.
+ Se han añadido [varios modos nuevos de `DESCRIBE` de SPARQL](sparql-query-hints-for-describe.md) junto con sugerencias de consulta para configurarlos.

## Mejoras en esta versión del motor
<a name="engine-releases-1.2.0.2-improvements"></a>
+ Se ha mejorado el rendimiento de openCypher, especialmente para las consultas de VLP.
+ Se ha mejorado el rendimiento del DFE para las consultas de Gremlin con límites distintos de los terminales, como, por ejemplo:

  ```
  g.withSideEffect('Neptune#useDFE',true).V().hasLabel('Student').limit(5).out('takesCourse')
  ```

## Versiones de lenguaje de consulta admitidas en esta versión
<a name="engine-releases-1.2.0.2-query-versions"></a>

Antes de actualizar un clúster de base de datos a la versión 1.2.0.2, asegúrese de que el proyecto sea compatible con estas versiones de lenguaje de consulta:
+ *Compatible con la primera versión de Gremlin:* `3.5.2`
+ *Compatible con la última versión de Gremlin:* `3.5.4`
+ *Versión de openCypher:* `Neptune-9.0.20190305-1.0`
+ *Versión de SPARQL:* `1.1`

## Rutas de actualización a la versión 1.2.0.2 del motor
<a name="engine-releases-1.2.0.2-upgrade-paths"></a>

## Actualización a esta versión
<a name="engine-releases-1.2.0.2-upgrading"></a>

La versión 1.2.0.2 de Amazon Neptune ya está disponible con carácter general.

Si un clúster de base de datos ejecuta una versión de motor desde la que existe una ruta de actualización a esta versión, puede actualizarse ahora. Puede actualizar cualquier clúster que cumpla los requisitos mediante las operaciones del clúster de base de datos de la consola o mediante el SDK. El siguiente comando de la CLI actualizará inmediatamente un clúster que cumpla los requisitos:

Para Linux, OS X o Unix:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --apply-immediately
```

Las actualizaciones se aplican a todas las instancias en un clúster de base de datos simultáneamente. Una actualización requiere un reinicio de la base de datos en esas instancias, por lo que se experimentará un tiempo de inactividad que oscila entre 20-30 segundos y varios minutos, tras el cual se puede reanudar el uso del clúster de base de datos.

### Realice siempre una prueba antes de realizar la actualización
<a name="engine-1.2.0.2-test-before-upgrading"></a>

Cuando se publique una nueva versión principal o secundaria del motor de Neptune, pruebe siempre las aplicaciones de Neptune en ella antes de actualizar. Incluso en una actualización secundaria podría haber nuevas características o comportamientos que podrían afectar al código.

Comience por comparar las páginas de notas de la versión actual con las de la versión de destino para ver si hay cambios en las versiones del lenguaje de consulta u otros cambios importantes.

La mejor forma de probar una nueva versión antes de actualizar el clúster de base de datos de producción es clonar el clúster de producción para que el clon ejecute la nueva versión del motor. A continuación, puede ejecutar consultas en el clon sin que eso afecte al clúster de base de datos de producción.

### Cree siempre una instantánea manual antes de realizar la actualización
<a name="engine-1.2.0.2-snapshot-before-upgrading"></a>

Antes de realizar una actualización, se recomienda crear siempre una instantánea manual del clúster de base de datos. Una instantánea automática solo ofrece protección a corto plazo, mientras que una instantánea manual está disponible hasta que la elimine explícitamente.

En algunos casos, Neptune crea una instantánea manual para usted como parte del proceso de actualización, pero no debe confiar en eso y crear su propia instantánea manual.

Cuando tenga la seguridad de que no necesitará revertir el clúster de base de datos al estado anterior a la actualización, puede eliminar de forma explícita la instantánea manual que ha creado, así como la instantánea manual que Neptune podría haber creado. Si Neptune crea una instantánea manual, tendrá un nombre que empieza por `preupgrade`, seguido del nombre del clúster de base de datos, la versión del motor de origen, la versión del motor de destino y la fecha.

**nota**  
Si intenta realizar la actualización mientras hay [una acción pendiente en proceso](manage-console-maintaining), es posible que se produzca un error como el siguiente:  

```
   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.
```
Si se produce este error, espere a que finalice la acción pendiente o active inmediatamente un periodo de mantenimiento para que se complete la actualización anterior.

Para obtener más información sobre la actualización de la versión del motor, consulte [Mantenimiento del clúster de base de datos de Amazon Neptune](cluster-maintenance.md). Si tiene alguna duda, el equipo de AWS Support está disponible en los foros de la comunidad y a través de [AWS Premium Support](https://aws.amazon.com/support).

# Versión 1.2.0.2.R6 del motor de Amazon Neptune (12/09/2023)
<a name="engine-releases-1.2.0.2.R6"></a>

A partir del 12 de septiembre de 2023, se implementará de forma general la versión 1.2.0.2.R6 del motor. Tenga en cuenta que las versiones nuevas tardan unos días en estar disponibles en todas las regiones.

**nota**  
**Si se realiza la actualización desde una versión del motor anterior a la 1.2.0.0:**  
En la [versión 1.2.0.0 del motor](engine-releases-1.2.0.0.md), se introdujo un nuevo formato para los grupos de parámetros personalizados y los grupos de parámetros de clústeres personalizados. En consecuencia, si va a actualizar una versión de motor anterior a la 1.2.0.0 a una versión de motor 1.2.0.0 o posterior, debe volver a crear todos los grupos de parámetros personalizados y los grupos de parámetros de clúster personalizados existentes utilizando la familia de grupos de parámetros `neptune1.2`. En las versiones anteriores, se utilizaba la familia de grupos de parámetros `neptune1`, y esos grupos de parámetros no funcionan con la versión 1.2.0.0 y las versiones posteriores. Para obtener más información, consulte [Grupos de parámetros de Amazon Neptune](parameter-groups.md).
En la versión 1.2.0.0 del motor, también se introdujo un nuevo formato para los registros de deshacer. Como resultado, se deben purgar todos los registros de deshacer que se hayan creado con una versión anterior del motor y la métrica [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) de CloudWatch debe ser cero antes de que se pueda iniciar una actualización desde una versión anterior a la 1.2.0.0. Si hay demasiados registros de deshacer (200 000 o más), al intentar iniciar una actualización, es posible que se agote el tiempo de espera de la purga de los registros de deshacer.  
Para acelerar la velocidad de depuración, actualice la instancia del escritor del clúster, que es donde se realiza la depuración. Si lo hace antes de intentar la actualización, puede reducir el número de registros de deshacer antes de empezar. Si se aumenta el tamaño del escritor a un tipo de instancia 24XL, se puede aumentar la velocidad de purga a más de un millón de registros por hora.  
Si la métrica `UndoLogsListSize` de CloudWatch es muy grande, abra un caso de soporte para ayudarle a analizar estrategias adicionales para reducirla.
Por último, se ha producido un cambio importante en la versión 1.2.0.0 que afecta al código anterior que utilizaba el protocolo Bolt con autenticación de IAM. A partir de la versión 1.2.0.0, Bolt necesita una ruta de recursos para la firma de IAM. En Java, la ruta del recurso podría tener este aspecto: `request.setResourcePath("/openCypher"));`. En otros lenguajes, `/openCypher` se puede agregar al URI del punto de conexión. Para ver ejemplos, consulte [Uso del protocolo Bolt](access-graph-opencypher-bolt.md).

## Defectos corregidos en esta versión del motor
<a name="engine-releases-1.2.0.2.R6-defects"></a>
+ Se ha corregido un error de SPARQL que provocaba que el `REGEX` operador no funcionara correctamente cuando se llamaba desde un literal etiquetado en un lenguaje.
+ Se ha corregido un problema que provocaba que empeorara el rendimiento de las cargas masivas.

## Versiones de lenguaje de consulta admitidas en esta versión
<a name="engine-releases-1.2.0.2.R6-query-versions"></a>

Antes de actualizar un clúster de base de datos a la versión 1.2.0.2.R6, asegúrese de que el proyecto sea compatible con estas versiones de lenguaje de consulta:
+ *Compatible con la primera versión de Gremlin:* `3.5.2`
+ *Compatible con la última versión de Gremlin:* `3.5.5`
+ *Versión de openCypher:* `Neptune-9.0.20190305-1.0`
+ *Versión de SPARQL:* `1.1`

## Rutas de actualización a la versión 1.2.0.2.R6 del motor
<a name="engine-releases-1.2.0.2.R6-upgrade-paths"></a>

El clúster de base de datos de Neptune se actualizará automáticamente a esta versión de parche de mantenimiento durante el siguiente periodo de mantenimiento si está ejecutando la versión `1.2.0.2` del motor.

## Actualización a esta versión
<a name="engine-releases-1.2.0.2.R6-upgrading"></a>

La versión 1.2.0.2.R6 de Amazon Neptune ya está disponible con carácter general.

Si un clúster de base de datos ejecuta una versión de motor desde la que existe una ruta de actualización a esta versión, puede actualizarse ahora. Puede actualizar cualquier clúster que cumpla los requisitos mediante las operaciones del clúster de base de datos de la consola o mediante el SDK. El siguiente comando de la CLI actualizará inmediatamente un clúster que cumpla los requisitos:

Para Linux, OS X o Unix:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --apply-immediately
```

Las actualizaciones se aplican a todas las instancias en un clúster de base de datos simultáneamente. Una actualización requiere un reinicio de la base de datos en esas instancias, por lo que se experimentará un tiempo de inactividad que oscila entre 20-30 segundos y varios minutos, tras el cual se puede reanudar el uso del clúster de base de datos.

### Realice siempre una prueba antes de realizar la actualización
<a name="engine-1.2.0.2.R6-test-before-upgrading"></a>

Cuando se publique una nueva versión principal o secundaria del motor de Neptune, pruebe siempre las aplicaciones de Neptune en ella antes de actualizar. Incluso en una actualización secundaria podría haber nuevas características o comportamientos que podrían afectar al código.

Comience por comparar las páginas de notas de la versión actual con las de la versión de destino para ver si hay cambios en las versiones del lenguaje de consulta u otros cambios importantes.

La mejor forma de probar una nueva versión antes de actualizar el clúster de base de datos de producción es clonar el clúster de producción para que el clon ejecute la nueva versión del motor. A continuación, puede ejecutar consultas en el clon sin que eso afecte al clúster de base de datos de producción.

### Cree siempre una instantánea manual antes de realizar la actualización
<a name="engine-1.2.0.2.R6-snapshot-before-upgrading"></a>

Antes de realizar una actualización, se recomienda crear siempre una instantánea manual del clúster de base de datos. Una instantánea automática solo ofrece protección a corto plazo, mientras que una instantánea manual está disponible hasta que la elimine explícitamente.

En algunos casos, Neptune crea una instantánea manual para usted como parte del proceso de actualización, pero no debe confiar en eso y crear su propia instantánea manual.

Cuando tenga la seguridad de que no necesitará revertir el clúster de base de datos al estado anterior a la actualización, puede eliminar de forma explícita la instantánea manual que ha creado, así como la instantánea manual que Neptune podría haber creado. Si Neptune crea una instantánea manual, tendrá un nombre que empieza por `preupgrade`, seguido del nombre del clúster de base de datos, la versión del motor de origen, la versión del motor de destino y la fecha.

**nota**  
Si intenta realizar la actualización mientras hay [una acción pendiente en proceso](manage-console-maintaining), es posible que se produzca un error como el siguiente:  

```
   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.
```
Si se produce este error, espere a que finalice la acción pendiente o active inmediatamente un periodo de mantenimiento para que se complete la actualización anterior.

Para obtener más información sobre la actualización de la versión del motor, consulte [Mantenimiento del clúster de base de datos de Amazon Neptune](cluster-maintenance.md). Si tiene alguna duda, el equipo de AWS Support está disponible en los foros de la comunidad y a través de [AWS Premium Support](https://aws.amazon.com/support).

# Versión 1.2.0.2.R5 del motor de Amazon Neptune (16/08/2023)
<a name="engine-releases-1.2.0.2.R5"></a>

A partir del 16 de agosto de 2023, se implementará de forma general la versión 1.2.0.2.R5 del motor. Tenga en cuenta que las versiones nuevas tardan unos días en estar disponibles en todas las regiones.

**importante**  
En algunos casos, ese posible que los cambios introducidos en esta versión del motor provoquen una disminución en el rendimiento de las cargas masivas. En consecuencia, las actualizaciones a esta versión se han suspendido temporalmente hasta que se resuelva el problema.

**nota**  
**Si se realiza la actualización desde una versión del motor anterior a la 1.2.0.0:**  
En la [versión 1.2.0.0 del motor](engine-releases-1.2.0.0.md), se introdujo un nuevo formato para los grupos de parámetros personalizados y los grupos de parámetros de clústeres personalizados. En consecuencia, si va a actualizar una versión de motor anterior a la 1.2.0.0 a una versión de motor 1.2.0.0 o posterior, debe volver a crear todos los grupos de parámetros personalizados y los grupos de parámetros de clúster personalizados existentes utilizando la familia de grupos de parámetros `neptune1.2`. En las versiones anteriores, se utilizaba la familia de grupos de parámetros `neptune1`, y esos grupos de parámetros no funcionan con la versión 1.2.0.0 y las versiones posteriores. Para obtener más información, consulte [Grupos de parámetros de Amazon Neptune](parameter-groups.md).
En la versión 1.2.0.0 del motor, también se introdujo un nuevo formato para los registros de deshacer. Como resultado, se deben purgar todos los registros de deshacer que se hayan creado con una versión anterior del motor y la métrica [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) de CloudWatch debe ser cero antes de que se pueda iniciar una actualización desde una versión anterior a la 1.2.0.0. Si hay demasiados registros de deshacer (200 000 o más), al intentar iniciar una actualización, es posible que se agote el tiempo de espera de la purga de los registros de deshacer.  
Para acelerar la velocidad de depuración, actualice la instancia del escritor del clúster, que es donde se realiza la depuración. Si lo hace antes de intentar la actualización, puede reducir el número de registros de deshacer antes de empezar. Si se aumenta el tamaño del escritor a un tipo de instancia 24XL, se puede aumentar la velocidad de purga a más de un millón de registros por hora.  
Si la métrica `UndoLogsListSize` de CloudWatch es muy grande, abra un caso de soporte para ayudarle a analizar estrategias adicionales para reducirla.
Por último, se ha producido un cambio importante en la versión 1.2.0.0 que afecta al código anterior que utilizaba el protocolo Bolt con autenticación de IAM. A partir de la versión 1.2.0.0, Bolt necesita una ruta de recursos para la firma de IAM. En Java, la ruta del recurso podría tener este aspecto: `request.setResourcePath("/openCypher"));`. En otros lenguajes, `/openCypher` se puede agregar al URI del punto de conexión. Para ver ejemplos, consulte [Uso del protocolo Bolt](access-graph-opencypher-bolt.md).

## Defectos corregidos en esta versión del motor
<a name="engine-releases-1.2.0.2.R5-defects"></a>
+ Se ha corregido un error de Gremlin por el que `order()` no podía ordenar correctamente las salidas de cadena cuando algunas de ellas incluían un carácter de espacio.
+ Se ha corregido un error de Gremlin que provocaba que se produjera una fuga de transacciones al comprobar el punto de conexión del estado de la consulta de Gremlin de las consultas con predicados en los recorridos secundarios para los pasos que no se procesaban de forma nativa.
+ Se ha corregido un error de openCypher en la gestión de transacciones de Bolt.
+ Se ha corregido un problema de simultaneidad en la capa de almacenamiento que podía provocar un bloqueo.

## Versiones de lenguaje de consulta admitidas en esta versión
<a name="engine-releases-1.2.0.2.R5-query-versions"></a>

Antes de actualizar un clúster de base de datos a la versión 1.2.0.2.R5, asegúrese de que el proyecto sea compatible con estas versiones de lenguaje de consulta:
+ *Compatible con la primera versión de Gremlin:* `3.5.2`
+ *Compatible con la última versión de Gremlin:* `3.5.5`
+ *Versión de openCypher:* `Neptune-9.0.20190305-1.0`
+ *Versión de SPARQL:* `1.1`

## Rutas de actualización a la versión 1.2.0.2.R5 del motor
<a name="engine-releases-1.2.0.2.R5-upgrade-paths"></a>

El clúster de base de datos de Neptune se actualizará automáticamente a esta versión de parche de mantenimiento durante el siguiente periodo de mantenimiento si está ejecutando la versión `1.2.0.2` del motor.

## Actualización a esta versión
<a name="engine-releases-1.2.0.2.R5-upgrading"></a>

La versión 1.2.0.2.R5 de Amazon Neptune ya está disponible con carácter general.

Si un clúster de base de datos ejecuta una versión de motor desde la que existe una ruta de actualización a esta versión, puede actualizarse ahora. Puede actualizar cualquier clúster que cumpla los requisitos mediante las operaciones del clúster de base de datos de la consola o mediante el SDK. El siguiente comando de la CLI actualizará inmediatamente un clúster que cumpla los requisitos:

Para Linux, OS X o Unix:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --apply-immediately
```

Las actualizaciones se aplican a todas las instancias en un clúster de base de datos simultáneamente. Una actualización requiere un reinicio de la base de datos en esas instancias, por lo que se experimentará un tiempo de inactividad que oscila entre 20-30 segundos y varios minutos, tras el cual se puede reanudar el uso del clúster de base de datos.

### Realice siempre una prueba antes de realizar la actualización
<a name="engine-1.2.0.2.R5-test-before-upgrading"></a>

Cuando se publique una nueva versión principal o secundaria del motor de Neptune, pruebe siempre las aplicaciones de Neptune en ella antes de actualizar. Incluso en una actualización secundaria podría haber nuevas características o comportamientos que podrían afectar al código.

Comience por comparar las páginas de notas de la versión actual con las de la versión de destino para ver si hay cambios en las versiones del lenguaje de consulta u otros cambios importantes.

La mejor forma de probar una nueva versión antes de actualizar el clúster de base de datos de producción es clonar el clúster de producción para que el clon ejecute la nueva versión del motor. A continuación, puede ejecutar consultas en el clon sin que eso afecte al clúster de base de datos de producción.

### Cree siempre una instantánea manual antes de realizar la actualización
<a name="engine-1.2.0.2.R5-snapshot-before-upgrading"></a>

Antes de realizar una actualización, se recomienda crear siempre una instantánea manual del clúster de base de datos. Una instantánea automática solo ofrece protección a corto plazo, mientras que una instantánea manual está disponible hasta que la elimine explícitamente.

En algunos casos, Neptune crea una instantánea manual para usted como parte del proceso de actualización, pero no debe confiar en eso y crear su propia instantánea manual.

Cuando tenga la seguridad de que no necesitará revertir el clúster de base de datos al estado anterior a la actualización, puede eliminar de forma explícita la instantánea manual que ha creado, así como la instantánea manual que Neptune podría haber creado. Si Neptune crea una instantánea manual, tendrá un nombre que empieza por `preupgrade`, seguido del nombre del clúster de base de datos, la versión del motor de origen, la versión del motor de destino y la fecha.

**nota**  
Si intenta realizar la actualización mientras hay [una acción pendiente en proceso](manage-console-maintaining), es posible que se produzca un error como el siguiente:  

```
   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.
```
Si se produce este error, espere a que finalice la acción pendiente o active inmediatamente un periodo de mantenimiento para que se complete la actualización anterior.

Para obtener más información sobre la actualización de la versión del motor, consulte [Mantenimiento del clúster de base de datos de Amazon Neptune](cluster-maintenance.md). Si tiene alguna duda, el equipo de AWS Support está disponible en los foros de la comunidad y a través de [AWS Premium Support](https://aws.amazon.com/support).

# Versión 1.2.0.2.R4 del motor de Amazon Neptune (08/05/2023)
<a name="engine-releases-1.2.0.2.R4"></a>

A partir del 8 de mayo de 2023, se implementará de forma general la versión 1.2.0.2.R4 del motor. Tenga en cuenta que las versiones nuevas tardan unos días en estar disponibles en todas las regiones.

**nota**  
**Si se realiza la actualización desde una versión del motor anterior a la 1.2.0.0:**  
En la [versión 1.2.0.0 del motor](engine-releases-1.2.0.0.md), se introdujo un nuevo formato para los grupos de parámetros personalizados y los grupos de parámetros de clústeres personalizados. En consecuencia, si va a actualizar una versión de motor anterior a la 1.2.0.0 a una versión de motor 1.2.0.0 o posterior, debe volver a crear todos los grupos de parámetros personalizados y los grupos de parámetros de clúster personalizados existentes utilizando la familia de grupos de parámetros `neptune1.2`. En las versiones anteriores, se utilizaba la familia de grupos de parámetros `neptune1`, y esos grupos de parámetros no funcionan con la versión 1.2.0.0 y las versiones posteriores. Para obtener más información, consulte [Grupos de parámetros de Amazon Neptune](parameter-groups.md).
En la versión 1.2.0.0 del motor, también se introdujo un nuevo formato para los registros de deshacer. Como resultado, se deben purgar todos los registros de deshacer que se hayan creado con una versión anterior del motor y la métrica [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) de CloudWatch debe ser cero antes de que se pueda iniciar una actualización desde una versión anterior a la 1.2.0.0. Si hay demasiados registros de deshacer (200 000 o más), al intentar iniciar una actualización, es posible que se agote el tiempo de espera de la purga de los registros de deshacer.  
Para acelerar la velocidad de depuración, actualice la instancia del escritor del clúster, que es donde se realiza la depuración. Si lo hace antes de intentar la actualización, puede reducir el número de registros de deshacer antes de empezar. Si se aumenta el tamaño del escritor a un tipo de instancia 24XL, se puede aumentar la velocidad de purga a más de un millón de registros por hora.  
Si la métrica `UndoLogsListSize` de CloudWatch es muy grande, abra un caso de soporte para ayudarle a analizar estrategias adicionales para reducirla.
Por último, se ha producido un cambio importante en la versión 1.2.0.0 que afecta al código anterior que utilizaba el protocolo Bolt con autenticación de IAM. A partir de la versión 1.2.0.0, Bolt necesita una ruta de recursos para la firma de IAM. En Java, la ruta del recurso podría tener este aspecto: `request.setResourcePath("/openCypher"));`. En otros lenguajes, `/openCypher` se puede agregar al URI del punto de conexión. Para ver ejemplos, consulte [Uso del protocolo Bolt](access-graph-opencypher-bolt.md).

## Defectos corregidos en esta versión del motor
<a name="engine-releases-1.2.0.2.R4-defects"></a>
+ Se ha corregido un error de SPARQL que provocaba que se introdujera una gran cantidad de valores a través de una cláusula `VALUES` que podía provocar una disminución del rendimiento.

## Versiones de lenguaje de consulta admitidas en esta versión
<a name="engine-releases-1.2.0.2.R4-query-versions"></a>

Antes de actualizar un clúster de base de datos a la versión 1.2.0.2.R4, asegúrese de que el proyecto sea compatible con estas versiones de lenguaje de consulta:
+ *Compatible con la primera versión de Gremlin:* `3.5.2`
+ *Compatible con la última versión de Gremlin:* `3.5.6`
+ *Versión de openCypher:* `Neptune-9.0.20190305-1.0`
+ *Versión de SPARQL:* `1.1`

## Rutas de actualización a la versión 1.2.0.2.R4 del motor
<a name="engine-releases-1.2.0.2.R4-upgrade-paths"></a>

El clúster de base de datos de Neptune se actualizará automáticamente a esta versión de parche de mantenimiento durante el siguiente periodo de mantenimiento si está ejecutando la versión `1.2.0.2` del motor.

## Actualización a esta versión
<a name="engine-releases-1.2.0.2.R4-upgrading"></a>

La versión 1.2.0.2.R4 de Amazon Neptune ya está disponible con carácter general.

Si un clúster de base de datos ejecuta una versión de motor desde la que existe una ruta de actualización a esta versión, puede actualizarse ahora. Puede actualizar cualquier clúster que cumpla los requisitos mediante las operaciones del clúster de base de datos de la consola o mediante el SDK. El siguiente comando de la CLI actualizará inmediatamente un clúster que cumpla los requisitos:

Para Linux, OS X o Unix:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --apply-immediately
```

Las actualizaciones se aplican a todas las instancias en un clúster de base de datos simultáneamente. Una actualización requiere un reinicio de la base de datos en esas instancias, por lo que se experimentará un tiempo de inactividad que oscila entre 20-30 segundos y varios minutos, tras el cual se puede reanudar el uso del clúster de base de datos.

### Realice siempre una prueba antes de realizar la actualización
<a name="engine-1.2.0.2.R4-test-before-upgrading"></a>

Cuando se publique una nueva versión principal o secundaria del motor de Neptune, pruebe siempre las aplicaciones de Neptune en ella antes de actualizar. Incluso en una actualización secundaria podría haber nuevas características o comportamientos que podrían afectar al código.

Comience por comparar las páginas de notas de la versión actual con las de la versión de destino para ver si hay cambios en las versiones del lenguaje de consulta u otros cambios importantes.

La mejor forma de probar una nueva versión antes de actualizar el clúster de base de datos de producción es clonar el clúster de producción para que el clon ejecute la nueva versión del motor. A continuación, puede ejecutar consultas en el clon sin que eso afecte al clúster de base de datos de producción.

### Cree siempre una instantánea manual antes de realizar la actualización
<a name="engine-1.2.0.2.R4-snapshot-before-upgrading"></a>

Antes de realizar una actualización, se recomienda crear siempre una instantánea manual del clúster de base de datos. Una instantánea automática solo ofrece protección a corto plazo, mientras que una instantánea manual está disponible hasta que la elimine explícitamente.

En algunos casos, Neptune crea una instantánea manual para usted como parte del proceso de actualización, pero no debe confiar en eso y crear su propia instantánea manual.

Cuando tenga la seguridad de que no necesitará revertir el clúster de base de datos al estado anterior a la actualización, puede eliminar de forma explícita la instantánea manual que ha creado, así como la instantánea manual que Neptune podría haber creado. Si Neptune crea una instantánea manual, tendrá un nombre que empieza por `preupgrade`, seguido del nombre del clúster de base de datos, la versión del motor de origen, la versión del motor de destino y la fecha.

**nota**  
Si intenta realizar la actualización mientras hay [una acción pendiente en proceso](manage-console-maintaining), es posible que se produzca un error como el siguiente:  

```
   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.
```
Si se produce este error, espere a que finalice la acción pendiente o active inmediatamente un periodo de mantenimiento para que se complete la actualización anterior.

Para obtener más información sobre la actualización de la versión del motor, consulte [Mantenimiento del clúster de base de datos de Amazon Neptune](cluster-maintenance.md). Si tiene alguna duda, el equipo de AWS Support está disponible en los foros de la comunidad y a través de [AWS Premium Support](https://aws.amazon.com/support).

# Versión 1.2.0.2.R3 del motor de Amazon Neptune (27/03/2023)
<a name="engine-releases-1.2.0.2.R3"></a>

A partir del 27 de marzo de 2023, se implementará de forma general la versión 1.2.0.2.R3 del motor. Tenga en cuenta que las versiones nuevas tardan unos días en estar disponibles en todas las regiones.

**nota**  
**Si se realiza la actualización desde una versión del motor anterior a la 1.2.0.0:**  
En la [versión 1.2.0.0 del motor](engine-releases-1.2.0.0.md), se introdujo un nuevo formato para los grupos de parámetros personalizados y los grupos de parámetros de clústeres personalizados. En consecuencia, si va a actualizar una versión de motor anterior a la 1.2.0.0 a una versión de motor 1.2.0.0 o posterior, debe volver a crear todos los grupos de parámetros personalizados y los grupos de parámetros de clúster personalizados existentes utilizando la familia de grupos de parámetros `neptune1.2`. En las versiones anteriores, se utilizaba la familia de grupos de parámetros `neptune1`, y esos grupos de parámetros no funcionan con la versión 1.2.0.0 y las versiones posteriores. Para obtener más información, consulte [Grupos de parámetros de Amazon Neptune](parameter-groups.md).
En la versión 1.2.0.0 del motor, también se introdujo un nuevo formato para los registros de deshacer. Como resultado, se deben purgar todos los registros de deshacer que se hayan creado con una versión anterior del motor y la métrica [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) de CloudWatch debe ser cero antes de que se pueda iniciar una actualización desde una versión anterior a la 1.2.0.0. Si hay demasiados registros de deshacer (200 000 o más), al intentar iniciar una actualización, es posible que se agote el tiempo de espera de la purga de los registros de deshacer.  
Para acelerar la velocidad de depuración, actualice la instancia del escritor del clúster, que es donde se realiza la depuración. Si lo hace antes de intentar la actualización, puede reducir el número de registros de deshacer antes de empezar. Si se aumenta el tamaño del escritor a un tipo de instancia 24XL, se puede aumentar la velocidad de purga a más de un millón de registros por hora.  
Si la métrica `UndoLogsListSize` de CloudWatch es muy grande, abra un caso de soporte para ayudarle a analizar estrategias adicionales para reducirla.
Por último, se ha producido un cambio importante en la versión 1.2.0.0 que afecta al código anterior que utilizaba el protocolo Bolt con autenticación de IAM. A partir de la versión 1.2.0.0, Bolt necesita una ruta de recursos para la firma de IAM. En Java, la ruta del recurso podría tener este aspecto: `request.setResourcePath("/openCypher"));`. En otros lenguajes, `/openCypher` se puede agregar al URI del punto de conexión. Para ver ejemplos, consulte [Uso del protocolo Bolt](access-graph-opencypher-bolt.md).

## Mejoras en esta versión del motor
<a name="engine-releases-1.2.0.2.R3-improvements"></a>
+ Para los clústeres de bases de datos sin servidor, se ha cambiado la configuración de capacidad mínima a 1,0 NCU y la configuración máxima válida más baja a 2,5 NCU. Consulte [Escalado de capacidad en un clúster de base de datos de Neptune sin servidor](neptune-serverless-capacity-scaling.md)
+ Se ha añadido un parámetro `enableInterContainerTrafficEncryption` a todas las [API de Neptune ML](machine-learning-api-reference.md), que puede usar para habilitar y deshabilitar el cifrado de tráfico entre contenedores en trabajos de ajuste de hiperparámetros o de entrenamiento.

## Defectos corregidos en esta versión del motor
<a name="engine-releases-1.2.0.2.R3-defects"></a>
+ Se ha corregido un error de Gremlin por el que `option(Predicate)` impedía reconocer la sintaxis de Gremlin válida.
+ Se ha corregido un error de Gremlin que provocaba que las consultas no se limpiaran correctamente si fallaban porque incluían demasiados pasos.
+ Se ha corregido un error de corrección de Gremlin que afectaba a las consultas del DFE con `limit` como recorrido secundario de pasos no unidos a la unión que recurrían a Tinkerpop. Un ejemplo de una consulta de este tipo es:

  ```
  g.withSideEffect('Neptune#useDFE', true).V().as("a").select("a").by(out().limit(1))
  ```
+ Se ha corregido una posible fuga de transacciones de Gremlin cuando una consulta enviada como una cadena incluía `GroupCountStep`.
+ Se ha corregido un error de openCypher que provocaba que el tipo de valor de parámetro no se infiriera correctamente en una lista o lista de mapas.
+ Se ha corregido un error de openCypher por el que las consultas de actualización y devolución no gestionaban correctamente `orderBy`, `limit` ni `skip`.
+ Se ha corregido un error de openCypher que permitía anular los parámetros incluidos en una solicitud por los parámetros de otra solicitud simultánea.
+ Se ha corregido un error de SPARQL que provocaba que se introdujera una gran cantidad de valores en una cláusula `VALUES` que podía provocar una disminución del rendimiento.

## Versiones de lenguaje de consulta admitidas en esta versión
<a name="engine-releases-1.2.0.2.R3-query-versions"></a>

Antes de actualizar un clúster de base de datos a la versión 1.2.0.2.R3, asegúrese de que el proyecto sea compatible con estas versiones de lenguaje de consulta:
+ *Compatible con la primera versión de Gremlin:* `3.5.2`
+ *Compatible con la última versión de Gremlin:* `3.5.6`
+ *Versión de openCypher:* `Neptune-9.0.20190305-1.0`
+ *Versión de SPARQL:* `1.1`

## Rutas de actualización a la versión 1.2.0.2.R3 del motor
<a name="engine-releases-1.2.0.2.R3-upgrade-paths"></a>

El clúster de base de datos de Neptune se actualizará automáticamente a esta versión de parche de mantenimiento durante el siguiente periodo de mantenimiento si está ejecutando la versión `1.2.0.2` del motor.

## Actualización a esta versión
<a name="engine-releases-1.2.0.2.R3-upgrading"></a>

La versión 1.2.0.2.R3 de Amazon Neptune ya está disponible con carácter general.

Si un clúster de base de datos ejecuta una versión de motor desde la que existe una ruta de actualización a esta versión, puede actualizarse ahora. Puede actualizar cualquier clúster que cumpla los requisitos mediante las operaciones del clúster de base de datos de la consola o mediante el SDK. El siguiente comando de la CLI actualizará inmediatamente un clúster que cumpla los requisitos:

Para Linux, OS X o Unix:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --apply-immediately
```

Las actualizaciones se aplican a todas las instancias en un clúster de base de datos simultáneamente. Una actualización requiere un reinicio de la base de datos en esas instancias, por lo que se experimentará un tiempo de inactividad que oscila entre 20-30 segundos y varios minutos, tras el cual se puede reanudar el uso del clúster de base de datos.

### Realice siempre una prueba antes de realizar la actualización
<a name="engine-1.2.0.2.R3-test-before-upgrading"></a>

Cuando se publique una nueva versión principal o secundaria del motor de Neptune, pruebe siempre las aplicaciones de Neptune en ella antes de actualizar. Incluso en una actualización secundaria podría haber nuevas características o comportamientos que podrían afectar al código.

Comience por comparar las páginas de notas de la versión actual con las de la versión de destino para ver si hay cambios en las versiones del lenguaje de consulta u otros cambios importantes.

La mejor forma de probar una nueva versión antes de actualizar el clúster de base de datos de producción es clonar el clúster de producción para que el clon ejecute la nueva versión del motor. A continuación, puede ejecutar consultas en el clon sin que eso afecte al clúster de base de datos de producción.

### Cree siempre una instantánea manual antes de realizar la actualización
<a name="engine-1.2.0.2.R3-snapshot-before-upgrading"></a>

Antes de realizar una actualización, se recomienda crear siempre una instantánea manual del clúster de base de datos. Una instantánea automática solo ofrece protección a corto plazo, mientras que una instantánea manual está disponible hasta que la elimine explícitamente.

En algunos casos, Neptune crea una instantánea manual para usted como parte del proceso de actualización, pero no debe confiar en eso y crear su propia instantánea manual.

Cuando tenga la seguridad de que no necesitará revertir el clúster de base de datos al estado anterior a la actualización, puede eliminar de forma explícita la instantánea manual que ha creado, así como la instantánea manual que Neptune podría haber creado. Si Neptune crea una instantánea manual, tendrá un nombre que empieza por `preupgrade`, seguido del nombre del clúster de base de datos, la versión del motor de origen, la versión del motor de destino y la fecha.

**nota**  
Si intenta realizar la actualización mientras hay [una acción pendiente en proceso](manage-console-maintaining), es posible que se produzca un error como el siguiente:  

```
   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.
```
Si se produce este error, espere a que finalice la acción pendiente o active inmediatamente un periodo de mantenimiento para que se complete la actualización anterior.

Para obtener más información sobre la actualización de la versión del motor, consulte [Mantenimiento del clúster de base de datos de Amazon Neptune](cluster-maintenance.md). Si tiene alguna duda, el equipo de AWS Support está disponible en los foros de la comunidad y a través de [AWS Premium Support](https://aws.amazon.com/support).

# Versión 1.2.0.2.R2 del motor de Amazon Neptune (15/12/2022)
<a name="engine-releases-1.2.0.2.R2"></a>

A partir del 15 de diciembre de 2022, se implementará de forma general la versión 1.2.0.2.R2 del motor. Tenga en cuenta que las versiones nuevas tardan unos días en estar disponibles en todas las regiones.

**nota**  
**Si se realiza la actualización desde una versión del motor anterior a la 1.2.0.0:**  
En la [versión 1.2.0.0 del motor](engine-releases-1.2.0.0.md), se introdujo un nuevo formato para los grupos de parámetros personalizados y los grupos de parámetros de clústeres personalizados. En consecuencia, si va a actualizar una versión de motor anterior a la 1.2.0.0 a una versión de motor 1.2.0.0 o posterior, debe volver a crear todos los grupos de parámetros personalizados y los grupos de parámetros de clúster personalizados existentes utilizando la familia de grupos de parámetros `neptune1.2`. En las versiones anteriores, se utilizaba la familia de grupos de parámetros `neptune1`, y esos grupos de parámetros no funcionan con la versión 1.2.0.0 y las versiones posteriores. Para obtener más información, consulte [Grupos de parámetros de Amazon Neptune](parameter-groups.md).
En la versión 1.2.0.0 del motor, también se introdujo un nuevo formato para los registros de deshacer. Como resultado, se deben purgar todos los registros de deshacer que se hayan creado con una versión anterior del motor y la métrica [`UndoLogsListSize`](cw-metrics.md#cw-metrics-UndoLogListSize) de CloudWatch debe ser cero antes de que se pueda iniciar una actualización desde una versión anterior a la 1.2.0.0. Si hay demasiados registros de deshacer (200 000 o más), al intentar iniciar una actualización, es posible que se agote el tiempo de espera de la purga de los registros de deshacer.  
Para acelerar la velocidad de depuración, actualice la instancia del escritor del clúster, que es donde se realiza la depuración. Si lo hace antes de intentar la actualización, puede reducir el número de registros de deshacer antes de empezar. Si se aumenta el tamaño del escritor a un tipo de instancia 24XL, se puede aumentar la velocidad de purga a más de un millón de registros por hora.  
Si la métrica `UndoLogsListSize` de CloudWatch es muy grande, abra un caso de soporte para ayudarle a analizar estrategias adicionales para reducirla.
Por último, se ha producido un cambio importante en la versión 1.2.0.0 que afecta al código anterior que utilizaba el protocolo Bolt con autenticación de IAM. A partir de la versión 1.2.0.0, Bolt necesita una ruta de recursos para la firma de IAM. En Java, la ruta del recurso podría tener este aspecto: `request.setResourcePath("/openCypher"));`. En otros lenguajes, `/openCypher` se puede agregar al URI del punto de conexión. Para ver ejemplos, consulte [Uso del protocolo Bolt](access-graph-opencypher-bolt.md).

## Mejoras en esta versión del motor
<a name="engine-releases-1.2.0.2.R2-improvements"></a>
+ Se ha mejorado el rendimiento de las consultas de openCypher relacionadas con `MERGE` y `OPTIONAL MATCH`.
+ Se ha mejorado el rendimiento de las consultas de openCypher relacionadas con `UNWIND` de una lista de mapas de valores literales.
+ Se ha mejorado el rendimiento de las consultas de openCypher que tienen un filtro `IN` para `id`. Por ejemplo:

  ```
  MATCH (n) WHERE id(n) IN ['1', '2', '3'] RETURN n
  ```
+ Mejoras en el rendimiento y correcciones para varios operadores de Gremlin, incluidos `repeat`, `coalesce`, `store` y `aggregate`.

## Defectos corregidos en esta versión del motor
<a name="engine-releases-1.2.0.2.R2-defects"></a>
+ Se ha corregido un error de openCypher que provocaba que las consultas devolvieran la cadena `"null"`, en lugar de un valor nulo en Bolt y SPARQL-JSON.
+ Se ha corregido un error de Gremlin que provocaba que una etiqueta de paso adjunta `UnionStep` no se propagase al último elemento de la ruta de sus recorridos secundarios.
+ Se ha corregido un error de Gremlin que provocaba que `valueMap()` no se optimizara al realizar un recorrido `by()` en el motor DFE.
+ Se ha corregido un error de Gremlin que provocaba que las consultas de lectura ejecutadas como parte de una transacción de Gremlin más larga no bloquearan las filas.
+ Se ha corregido un error en el registro de auditoría que provocaba que se registrara información innecesaria y que algunos campos no aparecieran en los registros.
+ Se ha corregido un error en el registro de auditoría por el que no se registraba el ARN de IAM de las solicitudes HTTP a un clúster de base de datos habilitado para IAM.
+ Se ha corregido un error en la caché de búsqueda para limitar la memoria incremental utilizada para las escrituras en la caché.
+ Se ha corregido un error en la caché de búsqueda que implicaba configurar el modo de solo lectura para la caché de búsqueda cuando se producía un error en las escrituras.

## Versiones de lenguaje de consulta admitidas en esta versión
<a name="engine-releases-1.2.0.2.R2-query-versions"></a>

Antes de actualizar un clúster de base de datos a la versión 1.2.0.2.R2, asegúrese de que el proyecto sea compatible con estas versiones de lenguaje de consulta:
+ *Compatible con la primera versión de Gremlin:* `3.5.2`
+ *Compatible con la última versión de Gremlin:* `3.5.4`
+ *Versión de openCypher:* `Neptune-9.0.20190305-1.0`
+ *Versión de SPARQL:* `1.1`

## Rutas de actualización a la versión 1.2.0.2.R2 del motor
<a name="engine-releases-1.2.0.2.R2-upgrade-paths"></a>

El clúster de base de datos de Neptune se actualizará automáticamente a esta versión de parche de mantenimiento durante el siguiente periodo de mantenimiento si está ejecutando la versión `1.2.0.2` del motor.

## Actualización a esta versión
<a name="engine-releases-1.2.0.2.R2-upgrading"></a>

La versión 1.2.0.2.R2 de Amazon Neptune ya está disponible con carácter general.

Si un clúster de base de datos ejecuta una versión de motor desde la que existe una ruta de actualización a esta versión, puede actualizarse ahora. Puede actualizar cualquier clúster que cumpla los requisitos mediante las operaciones del clúster de base de datos de la consola o mediante el SDK. El siguiente comando de la CLI actualizará inmediatamente un clúster que cumpla los requisitos:

Para Linux, OS X o Unix:

```
1. aws neptune modify-db-cluster \
2.     --db-cluster-identifier (your-neptune-cluster) \
3.     --engine-version 1.2.0.2 \
4.     --apply-immediately
```

Para Windows:

```
1. aws neptune modify-db-cluster ^
2.     --db-cluster-identifier (your-neptune-cluster) ^
3.     --engine-version 1.2.0.2 ^
4.     --apply-immediately
```

Las actualizaciones se aplican a todas las instancias en un clúster de base de datos simultáneamente. Una actualización requiere un reinicio de la base de datos en esas instancias, por lo que se experimentará un tiempo de inactividad que oscila entre 20-30 segundos y varios minutos, tras el cual se puede reanudar el uso del clúster de base de datos.

### Realice siempre una prueba antes de realizar la actualización
<a name="engine-1.2.0.2.R2-test-before-upgrading"></a>

Cuando se publique una nueva versión principal o secundaria del motor de Neptune, pruebe siempre las aplicaciones de Neptune en ella antes de actualizar. Incluso en una actualización secundaria podría haber nuevas características o comportamientos que podrían afectar al código.

Comience por comparar las páginas de notas de la versión actual con las de la versión de destino para ver si hay cambios en las versiones del lenguaje de consulta u otros cambios importantes.

La mejor forma de probar una nueva versión antes de actualizar el clúster de base de datos de producción es clonar el clúster de producción para que el clon ejecute la nueva versión del motor. A continuación, puede ejecutar consultas en el clon sin que eso afecte al clúster de base de datos de producción.

### Cree siempre una instantánea manual antes de realizar la actualización
<a name="engine-1.2.0.2.R2-snapshot-before-upgrading"></a>

Antes de realizar una actualización, se recomienda crear siempre una instantánea manual del clúster de base de datos. Una instantánea automática solo ofrece protección a corto plazo, mientras que una instantánea manual está disponible hasta que la elimine explícitamente.

En algunos casos, Neptune crea una instantánea manual para usted como parte del proceso de actualización, pero no debe confiar en eso y crear su propia instantánea manual.

Cuando tenga la seguridad de que no necesitará revertir el clúster de base de datos al estado anterior a la actualización, puede eliminar de forma explícita la instantánea manual que ha creado, así como la instantánea manual que Neptune podría haber creado. Si Neptune crea una instantánea manual, tendrá un nombre que empieza por `preupgrade`, seguido del nombre del clúster de base de datos, la versión del motor de origen, la versión del motor de destino y la fecha.

**nota**  
Si intenta realizar la actualización mientras hay [una acción pendiente en proceso](manage-console-maintaining), es posible que se produzca un error como el siguiente:  

```
   We're sorry, your request to modify DB cluster (cluster identifier) has failed.
   Cannot modify engine version because instance (instance identifier) is
   running on an old configuration. Apply any pending maintenance actions on the instance before
   proceeding with the upgrade.
```
Si se produce este error, espere a que finalice la acción pendiente o active inmediatamente un periodo de mantenimiento para que se complete la actualización anterior.

Para obtener más información sobre la actualización de la versión del motor, consulte [Mantenimiento del clúster de base de datos de Amazon Neptune](cluster-maintenance.md). Si tiene alguna duda, el equipo de AWS Support está disponible en los foros de la comunidad y a través de [AWS Premium Support](https://aws.amazon.com/support).