Parâmetros do Amazon Neptune - Amazon Neptune

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á.

Parâmetros do Amazon Neptune

Gerencia a configuração de banco de dados no Amazon Neptune usando parâmetros em grupo de parâmetros. Os seguintes parâmetros estão disponíveis para configurar o banco de dados do Neptune:

 

 

Parâmetros obsoletos

neptune_enable_audit_log (parâmetro em nível de cluster)

Esse parâmetro alterna o registro em log de auditoria do Neptune.

Os valores permitidos são 0 (desabilitado) e 1 (habilitado). O valor padrão é 0.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

É possível publicar logs de auditoria no Amazon CloudWatch, conforme descrito em Usando a CLI para publicar registros de auditoria do Neptune no Logs CloudWatch .

neptune_enable_slow_query_log (parâmetro em nível de cluster)

Use esse parâmetro para habilitar ou desabilitar o atributo de registro em log de consultas lentas do Neptune.

Esse é um parâmetro dinâmico, o que significa que a alteração do valor não exige nem causa a reinicialização do cluster de banco de dados.

Os valores permitidos são:

  • info: permite o registro em log de consultas lentas e registra os atributos selecionados que podem estar contribuindo para o baixo desempenho.

  • debug: permite o registro em log de consultas lentas e registra todos os atributos disponíveis da execução da consulta.

  • disable: desabilita o registro em log de consultas lentas.

O valor padrão é disable.

É possível publicar logs de consultas lentas no Amazon CloudWatch, conforme descrito em Usando a CLI para publicar registros de consulta lenta do Neptune no Logs CloudWatch .

neptune_slow_query_log_threshold (parâmetro em nível de cluster)

Esse parâmetro especifica o limite de tempo de execução, em milissegundos, após o qual uma consulta é considerada lenta. Se o registro em log de consultas lentas estiver habilitado, as consultas executadas acima desse limite serão registradas junto com alguns dos atributos.

O valor padrão é cinco mil milissegundos (cinco segundos).

Esse é um parâmetro dinâmico, o que significa que a alteração do valor não exige nem causa a reinicialização do cluster de banco de dados.

neptune_lab_mode (parâmetro em nível de cluster)

Quando definido, esse parâmetro habilita atributos experimentais específicos do Neptune. Consulte Modo de laboratório do Neptune para verificar os recursos experimentais disponíveis no momento.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

Para habilitar ou desabilitar um recurso experimental, inclua (nome do recurso)=enabled ou (nome do recurso)=disabled neste parâmetro. Você pode habilitar ou desabilitar vários recursos separando-os com vírgulas, como este:

(nome do recurso 1)=enabled, (nome do recurso 2)=enabled

Os atributos do modo de laboratório geralmente são desabilitados por padrão. Uma exceção é o atributo DFEQueryEngine, que foi habilitado por padrão para uso com dicas de consulta (DFEQueryEngine=viaQueryHint) a partir da versão 1.0.5.0 do mecanismo do Neptune. A partir da versão 1.1.1.0 do mecanismo do Neptune, o mecanismo DFE não está mais no modo de laboratório e agora é controlado usando o parâmetro de instância neptune_dfe_query_engine no grupo de parâmetros de banco de dados de uma instância.

neptune_query_timeout (parâmetro em nível de cluster)

Especifica uma duração de tempo limite específica para consultas de grafo, em milissegundos.

Os valores permitidos variam de 10 a 2,147,483,647 (231 - 1). O valor padrão é 120,000 (2 minutos).

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

nota

Você poderá gerar custos inesperados se definir um valor de tempo limite de consulta muito alto, especialmente em uma instância sem servidor. Sem uma configuração de tempo limite razoável, você poderá emitir acidentalmente uma consulta que continue sendo executada por muito mais tempo do que o esperado, gerando custos jamais previstos. Isso é particularmente o caso em uma instância sem servidor cuja escala pode ser aumentada verticalmente para um tipo de instância grande e caro durante a execução da consulta.

É possível evitar despesas inesperadas desse tipo usando um valor de tempo limite de consulta que acomode a maioria das consultas e ocasione apenas um tempo limite de execução excepcionalmente longo.

neptune_streams (parâmetro em nível de cluster)

Habilita ou desabilita o Fluxos do Neptune.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

Os valores permitidos são 0 (desabilitado, que é o padrão), e 1 (habilitado).

neptune_streams_expiry_days (parâmetro em nível de cluster)

Especifica quantos dias decorrem antes que o servidor exclua os registros de fluxo.

Os valores permitidos são de 1 a 90. O padrão é 7.

Esse parâmetro foi apresentado na versão 1.2.0.0 do mecanismo.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

neptune_lookup_cache (parâmetro em nível de cluster)

Desabilita ou reabilita o cache de pesquisa do Neptune em instâncias R5d.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

Os valores permitidos são enabled e disabled. O valor padrão é disabled, mas sempre que uma instância R5d é criada no cluster de banco de dados, o parâmetro neptune_lookup_cache é automaticamente definido como enabled e um cache de pesquisa é criado nessa instância.

neptune_autoscaling_config (parâmetro em nível de cluster)

Define parâmetros de configuração para as instâncias de réplica de leitura que o ajuste de escala automático do Neptune cria e gerencia.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

Usando uma string JSON que você define como o valor do parâmetro neptune_autoscaling_config, é possível especificar:

  • O tipo de instância que o ajuste de escala automático do Neptune usa para todas as novas instâncias de réplica de leitura que ele cria.

  • As janelas de manutenção atribuídas a essas réplicas de leitura.

  • Tags a serem associadas a todas as novas réplicas de leitura.

A string JSON tem uma estrutura como esta:

"{ \"tags\": [ { \"key\" : \"reader tag-0 key\", \"value\" : \"reader tag-0 value\" }, { \"key\" : \"reader tag-1 key\", \"value\" : \"reader tag-1 value\" }, ], \"maintenanceWindow\" : \"wed:12:03-wed:12:33\", \"dbInstanceClass\" : \"db.r5.xlarge\" }"

Observe que as aspas dentro da string devem ter todas um caractere de escape que é uma barra invertida (\).

Qualquer uma das três definições de configuração não especificadas no parâmetro neptune_autoscaling_config é copiada da configuração da instância de gravador principal do cluster de banco de dados.

neptune_ml_iam_role (parâmetro em nível de cluster)

Especifica o ARN do perfil do IAM usado no Neptune ML. O valor pode ser qualquer ARN de perfil do IAM válido.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

É possível especificar o ARN do perfil do IAM padrão para machine learning em grafos.

neptune_ml_endpoint (parâmetro em nível de cluster)

Especifica o endpoint usado para o Neptune ML. O valor pode ser qualquer nome de endpoint do SageMaker válido.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

É possível especificar o endpoint padrão do SageMaker para machine learning em grafos.

neptune_dfe_query_engine (parâmetros em nível de instância)

A partir da versão 1.1.1.0 do mecanismo do Neptune, esse parâmetro de instância de banco de dados é usado para controlar como o mecanismo de consulta do DFE é usado. Os valores permitidos são os seguintes:

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

  • enabled: faz com que o mecanismo DFE seja usado sempre que possível, exceto quando a dica de consulta useDFE está presente e definida como false.

  • viaQueryHint (o padrão): faz com que o mecanismo DFE seja usado somente para consultas que incluam explicitamente a dica de consulta useDFE definida como true.

Se esse parâmetro não tiver sido definido explicitamente, o valor padrão, viaQueryHint, será usado quando a instância for iniciada.

nota

Todas as consultas do openCypher são executadas pelo mecanismo DFE, independentemente de como esse parâmetro é definido.

Antes da versão 1.1.1.0, era um parâmetro de modo de laboratório em vez de um parâmetro de instância de banco de dados.

neptune_query_timeout (parâmetros em nível de instância)

Esse parâmetro de instância de banco de dados especifica uma duração de tempo limite para consultas de grafos, em milissegundos, para uma instância.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

Os valores permitidos variam de 10 a 2,147,483,647 (231 - 1). O valor padrão é 120,000 (2 minutos).

nota

Você poderá gerar custos inesperados se definir um valor de tempo limite de consulta muito alto, especialmente em uma instância sem servidor. Sem uma configuração de tempo limite razoável, você poderá emitir acidentalmente uma consulta que continue sendo executada por muito mais tempo do que o esperado, gerando custos jamais previstos. Isso é particularmente o caso em uma instância sem servidor cuja escala pode ser aumentada verticalmente para um tipo de instância grande e caro durante a execução da consulta.

É possível evitar despesas inesperadas desse tipo usando um valor de tempo limite de consulta que acomode a maioria das consultas e ocasione apenas um tempo limite de execução excepcionalmente longo.

neptune_result_cache (parâmetros em nível de instância)

neptune_result_cache: esse parâmetro de instância de banco de dados habilita ou desabilita Armazenar em cache os resultados da consulta.

Esse parâmetro é estático, o que significa que as alterações nele não têm efeito em nenhuma instância até que ela seja reinicializada.

Os valores permitidos são 0 (desabilitado, que é o padrão) e 1 (habilitado).

neptune_enforce_ssl (parâmetro em nível de cluster obsoleto)

(Obsoleto) Costumava haver regiões que permitiam conexões HTTP com o Neptune, e esse parâmetro era usado para forçar todas as conexões a usarem HTTPS quando definido como 1. No entanto, esse parâmetro não é mais relevante, pois o Neptune agora só aceita conexões HTTPS em todas as regiões.