

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Modo de laboratório do Neptune
<a name="features-lab-mode"></a>

É possível usar o *modo de laboratório * do Amazon Neptune para habilitar novos atributos que estão na versão atual do mecanismo do Neptune, mas que ainda não estão prontos para uso em produção e não estão habilitados por padrão. Isso permite testar esses recursos em seus ambientes de desenvolvimento e teste.

## Usar o modo de laboratório do Neptune
<a name="features-lab-mode-using"></a>

Use o [parâmetro de cluster de banco de dados `neptune_lab_mode`](parameters.md#parameters-db-cluster-parameters-neptune_lab_mode) para habilitar ou desabilitar atributos. Para fazer isso, inclua `{{(feature name)}}=enabled` ou `{{(feature name)}}=disabled` no valor do parâmetro `neptune_lab_mode` no grupo de parâmetros do cluster de banco de dados.

Por exemplo, nesta versão do mecanismo, você pode definir o parâmetro `neptune_lab_mode` como `Streams=disabled, ReadWriteConflictDetection=enabled`.

Para obter informações sobre como editar o grupo de parâmetros do cluster de seu banco de dados, consulte [Edição de um grupo de parâmetros](parameter-groups.md#parameters-editgroup). Observe que você não pode editar o grupo de parâmetros de cluster de banco de dados padrão. Se estiver usando o grupo padrão, você deverá criar um novo grupo de parâmetros de cluster de banco de dados antes de definir o parâmetro `neptune_lab_mode`.

**nota**  
Ao fazer uma alteração em um parâmetro estático do cluster de banco de dados, como `neptune_lab_mode`, é necessário reiniciar a instância primária (de gravador) do cluster para que a alteração tenha efeito. Antes de [Versão: 1.2.0.0 (21/07/2022)](engine-releases-1.2.0.0.md), todas as réplicas de leitura em um cluster de banco de dados eram reinicializadas automaticamente quando a instância primária era reiniciada.  
A partir de [Versão: 1.2.0.0 (21/07/2022)](engine-releases-1.2.0.0.md), reiniciar a instância primária não faz com que as réplicas sejam reiniciadas. Isso significa que você deve reiniciar cada instância separadamente para obter uma alteração no parâmetro do cluster de banco de dados (consulte [Grupos de parâmetros](parameter-groups.md)).

**Importante**  
No momento, se você fornecer os parâmetros incorretos do modo de laboratório ou se sua solicitação falhar por outro motivo, talvez você não seja notificado da falha. É necessário sempre verificar se uma solicitação de alteração no modo de laboratório foi bem-sucedida chamando a [API de status](access-graph-status.md), conforme mostrado abaixo:  

```
curl -G https://{{your-neptune-endpoint}}:{{port}}/status
```
Os resultados do status incluem informações do modo de laboratório que mostrarão se as alterações solicitadas foram feitas ou não:  

```
{
  "status":"healthy",
  "startTime":"Wed Dec 29 02:29:24 UTC 2021",
  "dbEngineVersion":"development",
  "role":"writer",
  "dfeQueryEngine":"viaQueryHint",
  "gremlin":{"version":"tinkerpop-3.5.2"},
  "sparql":{"version":"sparql-1.1"},
  "opencypher":{"version":"Neptune-9.0.20190305-1.0"},
  "labMode":{
    "ObjectIndex":"disabled",
    "ReadWriteConflictDetection":"enabled"
  },
  "features":{
    "LookupCache":{"status":"Available"},
    "ResultCache":{"status":"disabled"},
    "IAMAuthentication":"disabled",
    "Streams":"disabled",
    "AuditLog":"disabled"
  },
  "settings":{"clusterQueryTimeoutInMs":"120000"}
}
```

No momento, os seguintes atributos são acessados no modo de laboratório:

## O índice OSGP
<a name="features-lab-mode-features-osgp-index"></a>

O Neptune agora pode manter um quarto índice, chamado de índice OSGP, que é útil para conjuntos de dados com um grande número de predicados (consulte [Habilitar um índice OSGP](feature-overview-storage-indexing.md#feature-overview-storage-indexing-osgp)).

É possível habilitar um índice OSGP em um novo cluster de banco de dados vazio do Neptune definindo `ObjectIndex=enabled` no parâmetro do cluster de banco de dados `neptune_lab_mode`. Um índice OSGP **só** pode ser habilitado em um novo cluster de banco de dados vazio.

Por padrão, o índice OSGP está desabilitado.

**nota**  
Depois de definir o parâmetro de cluster de banco de dados `neptune_lab_mode`para habilitar o índice OSGP, é necessário reiniciar a instância de gravador do cluster para que a alteração tenha efeito.

**Atenção**  
Se você desabilitar um índice OSGP habilitado configurando `ObjectIndex=disabled` e depois reabilitá-lo depois de adicionar mais dados, o índice não será criado corretamente. A reconstrução sob demanda do índice não é compatível, portanto, você só deve habilitar o índice OSGP quando o banco de dados estiver vazio.

## Habilitar a coleta de resíduos do dicionário
<a name="features-lab-mode-features-gc"></a>

A coleta de resíduos do dicionário pode ser habilitada para dados de grafos de propriedades quando o neptune-streams não está habilitado por meio do parâmetro `DictionaryGCMode`. A simultaneidade pode ser controlada pelo parâmetro `DictionaryGCConcurrency`. Consulte [Coleta de resíduos do dicionário](storage-gc.md) para obter mais detalhes.

## Semântica de transação formalizada
<a name="features-lab-mode-features-transaction-semantics"></a>

O Neptune atualizou a semântica formal para transações simultâneas (consulte [Semântica de transação no Neptune](transactions.md)).

Use `ReadWriteConflictDetection` como o nome no parâmetro `neptune_lab_mode` que habilita ou desabilita a semântica de transação formalizada.

Por padrão, a semântica de transação formalizada já está habilitada. Se você desejar reverter para o comportamento anterior, inclua `ReadWriteConflictDetection=disabled` no valor definido para o parâmetro `neptune_lab_mode` do cluster de banco de dados.

## Suporte estendido para data e hora
<a name="labmode-extended-datetime-support"></a>

 O Neptune estendeu o suporte para a funcionalidade de data e hora. Para habilitar a data e hora com formatos estendidos, inclua `DatetimeMillisecond=enabled` o parâmetro de cluster de banco de dados `neptune_lab_mode`. 

## StrictTimeoutValidation
<a name="labmode-StrictTimeoutValidation"></a>

**nota**  
Esse recurso está disponível a partir da versão 1.3.2.0 do [Neptune Engine](engine-releases-1.3.2.0.md).

 Valor padrão: ativado (desativado por padrão antes da versão 1.4.0.0 do [Neptune Engine](engine-releases-1.4.0.0.md)) 

 Valores permitidos: habilitado/desabilitado 

 Quando esse parâmetro é`enabled`, um valor de tempo limite por consulta especificado como opção de solicitação ou dica de consulta não pode exceder o valor definido globalmente na configuração do grupo de [`neptune_query_timeout`](parameters.md#parameters-db-cluster-parameters-neptune_query_timeout)parâmetros. Se o tempo limite por consulta exceder a configuração global, o Neptune lança um. `InvalidParameterException` Nas versões do mecanismo anteriores à 1.4.0.0, esse parâmetro era `disabled` padrão e precisava ser habilitado explicitamente. 

 Essa configuração pode ser confirmada em uma resposta no `/status` endpoint quando o valor for`disabled`. 

 Para obter mais informações, consulte [Tempos limite por consulta](best-practices-gremlin-java-per-query-timeout.md). 

## QRCMemoryEstimativa precisa
<a name="labmode-AccurateQRCMemoryEstimation"></a>

**nota**  
Esse recurso está disponível a partir da versão 1.4.0.0 do [Neptune Engine](engine-releases-1.4.0.0.md).

 Valor padrão: desabilitado 

 Valores permitidos: habilitado/desabilitado 

 Quando habilitado, o [cache de resultados da consulta Gremlin](https://docs.aws.amazon.com//neptune/latest/userguide/gremlin-results-cache.html) permite o armazenamento em cache dos resultados da consulta no banco de dados. Por padrão, a estimativa aproximada é usada para determinar o tamanho do resultado armazenado em cache. Com esse parâmetro `AccurateQRCMemoryEstimation` de modo de laboratório habilitado, a estimativa de tamanho dos resultados em cache usará estimativas de tamanho precisas em vez de aproximadas. Esse parâmetro de modo de laboratório está disponível a partir da versão 1.4.0.0 do mecanismo do Neptune. 