기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Neptune 파라미터
DB 파라미터 그룹에서 [파라미터 그룹](parameter-groups.md)을 사용하여 Amazon Neptune에서 데이터베이스 구성을 관리합니다. Neptune 데이터베이스를 구성하는 데 사용할 수 있는 파라미터는 다음과 같습니다.
**클러스터 수준 파라미터**
+ [neptune\_enable\_audit\_log](#parameters-db-cluster-parameters-neptune_enable_audit_log)
+ [neptune\_enable\_slow\_query\_log](#parameters-db-cluster-parameters-neptune_enable_slow_query_log)
+ [neptune\_slow\_query\_log\_threshold](#parameters-db-cluster-parameters-neptune_slow_query_log_threshold)
+ [neptune\_lab\_mode](#parameters-db-cluster-parameters-neptune_lab_mode)
+ [neptune\_query\_timeout](#parameters-db-cluster-parameters-neptune_query_timeout)
+ [neptune\_streams](#parameters-db-cluster-parameters-neptune_streams)
+ [neptune\_streams\_expiry\_days](#parameters-db-cluster-parameters-neptune_streams_expiry_days)
+ [neptune\_lookup\_cache](#parameters-db-cluster-parameters-neptune_lookup_cache)
+ [neptune\_autoscaling\_config](#parameters-db-cluster-parameters-neptune_autoscaling_config)
+ [neptune\_ml\_iam\_role](#parameters-db-cluster-parameters-neptune_ml_iam_role)
+ [neptune\_ml\_endpoint](#parameters-db-cluster-parameters-neptune_ml_endpoint)
+ [neptune\_enable\_inline\_server\_generated\_edge\_id](#parameters-db-cluster-parameters-neptune_inline_edge_id)
**인스턴스 수준 파라미터**
+ [neptune\_dfe\_query\_engine](#parameters-instance-parameters-neptune_dfe_query_engine)
+ [neptune\_query\_timeout](#parameters-instance-parameters-neptune_query_timeout)
+ [neptune\_result\_cache](#parameters-db-instance-parameters-neptune_result_cache)
+ [UndoLogPurgeConfig](#parameters-db-instance-parameters-undo_log_purge_config)
**사용 중단되는 파라미터**
+ [neptune\_enforce\_ssl](#parameters-db-cluster-parameters-neptune_enforce_ssl)
## `neptune_enable_audit_log`(클러스터 수준 파라미터)
이 파라미터는 Neptune의 감사 로깅을 전환합니다.
허용되는 값은 `0`(비활성화) 및 `1`(활성화)입니다. 기본값은 `0`입니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
[CLI를 사용하여 Neptune 감사 로그를 CloudWatch Logs에 게시](cloudwatch-logs.md#cloudwatch-logs-cli)에 설명된 대로 Amazon CloudWatch에 감사 로그를 게시할 수 있습니다.
## `neptune_enable_slow_query_log`(클러스터 수준 파라미터)
이 파라미터를 사용하여 Neptune의 [느린 쿼리 로깅](slow-query-logs.md) 기능을 활성화하거나 비활성화할 수 있습니다.
이는 동적 파라미터이므로 값을 변경해도 DB 클러스터를 다시 시작할 필요가 없으며 다시 시작해야 할 필요도 없습니다.
허용되는 값:
+ **`info`** - 느린 쿼리 로깅을 활성화하고 성능 저하의 원인이 될 수 있는 선택된 속성을 로깅합니다.
+ **`debug`** - 느린 쿼리 로깅을 활성화하고 쿼리 실행의 사용 가능한 모든 속성을 기록합니다.
+ **`disabled`** - 느린 쿼리 로깅을 비활성화합니다.
기본값은 `disabled`입니다.
[CLI를 사용하여 Neptune 느린 쿼리 로그를 CloudWatch Logs에 게시](cloudwatch-logs.md#cloudwatch-slow-query-logs-cli)에 설명된 대로 Amazon CloudWatch에 느린 쿼리 로그를 게시할 수 있습니다.
## `neptune_slow_query_log_threshold`(클러스터 수준 파라미터)
이 파라미터는 실행 시간 임곗값(밀리초)을 지정하며, 그 이후에는 쿼리가 느린 쿼리로 간주됩니다. [느린 쿼리 로깅](slow-query-logs.md)이 활성화된 경우 이 임곗값보다 오래 실행되는 쿼리는 일부 속성과 함께 로깅됩니다.
기본값은 5,000밀리초(5초)입니다.
이는 동적 파라미터이므로 값을 변경해도 DB 클러스터를 다시 시작할 필요가 없으며 다시 시작해야 할 필요도 없습니다.
## `neptune_lab_mode`(클러스터 수준 파라미터)
이 파라미터를 설정하면 Neptune의 특정 실험적 기능이 활성화됩니다. 현재 사용 가능한 실험적 기능은 [Neptune 랩 모드](features-lab-mode.md) 단원을 참조하세요.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
Lab Mode 기능은 일반적으로 비활성화되어 있습니다. 실험 기능을 활성화하거나 명시적으로 비활성화하려면이 파라미터에 {{(기능 이름)}}`=enabled` 또는 {{(기능 이름)}}`=disabled`을 포함합니다. 다음과 같이 쉼표로 구분하여 여러 기능을 활성화하거나 비활성화할 수 있습니다.
{{(기능 \#1 이름)}}`=enabled,` {{(기능 \#2 이름)}}`=enabled`
## `neptune_query_timeout`(클러스터 수준 파라미터)
그래프 쿼리의 특정 제한 시간 기간을 밀리초 단위로 지정합니다.
허용되는 값의 범위는 `10`\~`2,147,483,647`(231-1)입니다. 기본값은 `120,000`(2분)입니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
여러 제한 시간 설정(클러스터 수준, 인스턴스 수준 및 쿼리당)이 구성된 경우 다음 표에는 어떤 제한 시간 값이 우선하는지 나와 있습니다.
| 클러스터 PG | 인스턴스 PG | 쿼리 힌트 | 결과 |
| --- | --- | --- | --- |
| 기본값 | 기본값 | 없음 | Cluster |
| 사용자 지정 | 기본값 | 없음 | Cluster |
| 사용자 지정 | 사용자 지정 | 없음 | Instance |
| 기본값 | 사용자 지정 | 없음 | Instance |
| 임의 | 임의 | 가장 낮음 | Query |
| 기본값 | 사용자 지정 | 최저가 아님 | Instance |
| 사용자 지정 | 기본값 | 최저가 아님 | Cluster |
| 사용자 지정 | 사용자 지정 | 최저가 아님 | Instance |
**참고**
특히 서버리스 인스턴스에서 쿼리 제한 시간 값을 너무 높게 설정하면 예상치 못한 비용이 발생할 수 있습니다. 제한 시간을 적절하게 설정하지 않으면 의도치 않게 쿼리가 예상보다 훨씬 오래 실행되어 예상하지 못한 비용이 발생할 수 있습니다. 쿼리를 실행하는 동안 비용이 많이 드는 대규모 인스턴스 유형으로 스케일 업할 수 있는 서버리스 인스턴스의 경우 특히 그렇습니다.
대부분의 쿼리를 수용하고 예기치 않게 오래 실행되는 쿼리의 제한 시간만 발생시키는 쿼리 제한 시간 값을 사용하면 이런 종류의 예상치 못한 비용을 피할 수 있습니다.
## `neptune_streams`(클러스터 수준 파라미터)
[Neptune 스트림](streams.md)를 활성화하거나 비활성화합니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
허용되는 값은 `0`(비활성화: 기본값) 및 `1`(활성화)입니다.
## `neptune_streams_expiry_days`(클러스터 수준 파라미터)
서버에서 스트림 레코드를 삭제하기까지 경과되는 일수를 지정합니다.
허용되는 값은 `1`\~`90`이 포함됩니다. 기본값은 `7`입니다.
이 파라미터는 [엔진 버전 1.2.0.0](engine-releases-1.2.0.0.md)에 도입되었습니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
## `neptune_lookup_cache`(클러스터 수준 파라미터)
`R5d` 인스턴스에서 [Neptune 조회 캐시](feature-overview-lookup-cache.md)를 비활성화하거나 다시 활성화합니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
허용되는 값은 `1`(활성화) 및 `0`(비활성화)입니다. 기본값은 `0`이지만 DB 클러스터에서 `R5d` 인스턴스를 생성할 때마다 `neptune_lookup_cache` 파라미터가 자동으로 `1`로 설정되고 해당 인스턴스에 조회 캐시가 생성됩니다.
## `neptune_autoscaling_config`(클러스터 수준 파라미터)
[Neptune Auto Scaling](manage-console-autoscaling.md)에서 생성하고 관리하는 읽기 복제본 인스턴스의 구성 파라미터를 설정합니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
`neptune_autoscaling_config` 파라미터 값으로 설정한 JSON 문자열을 사용하여 다음을 지정할 수 있습니다.
+ Neptune Auto scaling에서 새로 생성하는 모든 읽기 전용 복제본 인스턴스에 사용하는 인스턴스 유형입니다.
+ 해당 읽기 전용 복제본에 할당된 유지 관리 기간입니다.
+ 모든 새 읽기 전용 복제본에 연결할 태그입니다.
JSON 문자열의 구조는 다음과 같습니다.
```
"{
\"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\"
}"
```
참고로 문자열 내의 따옴표는 모두 백슬래시 문자(`\`)로 이스케이프 처리해야 합니다.
`neptune_autoscaling_config` 파라미터에 지정되지 않은 세 가지 구성 설정은 모두 DB 클러스터의 기본 라이터 인스턴스 구성에서 복사됩니다.
## `neptune_ml_iam_role`(클러스터 수준 파라미터)
Neptune ML에서 사용되는 IAM 역할 ARN을 지정합니다. 값은 모든 유효한 IAM 역할 ARN일 수 있습니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
그래프에서 기계 학습을 위한 기본 IAM 역할 ARN을 지정할 수 있습니다.
## `neptune_ml_endpoint`(클러스터 수준 파라미터)
Neptune ML에 사용되는 엔드포인트를 지정합니다. 값은 임의의 유효한 [SageMaker AI 엔드포인트 이름](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateEndpoint.html#sagemaker-CreateEndpoint-request-EndpointName)일 수 있습니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
그래프에서 기계 학습을 위한 기본 SageMaker AI 엔드포인트를 지정할 수 있습니다.
## `neptune_enable_inline_server_generated_edge_id`(클러스터 수준 파라미터)
Neptune 인라인 서버 생성 Edge ID 기능을 활성화하거나 비활성화합니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
허용되는 값은 `1`(활성화) 및 `0`(비활성화)입니다. 기본값은 `0`입니다.
## `neptune_dfe_query_engine`(인스턴스 수준 파라미터)
이 DB 인스턴스 파라미터는 [DFE 쿼리 엔진](neptune-dfe-engine.md)의 사용 방식을 제어합니다. 값은 다음과 같습니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
+ **`enabled`** - `useDFE` 쿼리 힌트가 존재하고 `false` 설정된 경우를 제외하고 가능한 모든 곳에서 DFE 엔진을 사용합니다.
+ **`viaQueryHint`**(기본값) - `true` 설정된 `useDFE` 쿼리 힌트가 명시적으로 포함된 쿼리에만 DFE 엔진을 사용합니다.
이 파라미터가 명시적으로 설정되지 않은 경우 인스턴스가 시작될 때 기본값인 `viaQueryHint`가 사용됩니다.
**참고**
모든 openCypher 쿼리는 이 파라미터의 설정 방식에 관계없이 DFE 엔진에서 실행됩니다.
## `neptune_query_timeout`(인스턴스 수준 파라미터)
이 DB 인스턴스 파라미터는 인스턴스 하나에 대한 그래프 쿼리 제한 시간(밀리초)을 지정합니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
허용되는 값의 범위는 `10`\~`2,147,483,647`(231-1)입니다. 기본값은 `120,000`(2분)입니다.
**참고**
특히 서버리스 인스턴스에서 쿼리 제한 시간 값을 너무 높게 설정하면 예상치 못한 비용이 발생할 수 있습니다. 제한 시간을 적절하게 설정하지 않으면 의도치 않게 쿼리가 예상보다 훨씬 오래 실행되어 예상하지 못한 비용이 발생할 수 있습니다. 쿼리를 실행하는 동안 비용이 많이 드는 대규모 인스턴스 유형으로 스케일 업할 수 있는 서버리스 인스턴스의 경우 특히 그렇습니다.
대부분의 쿼리를 수용하고 예기치 않게 오래 실행되는 쿼리의 제한 시간만 발생시키는 쿼리 제한 시간 값을 사용하면 이런 종류의 예상치 못한 비용을 피할 수 있습니다.
## `neptune_result_cache`(인스턴스 수준 파라미터)
**`neptune_result_cache`** - 이 DB 인스턴스 파라미터는 [쿼리 결과 캐싱](gremlin-results-cache.md)를 활성화하거나 비활성화합니다.
이 파라미터는 정적입니다. 즉, 파라미터에 대한 변경 사항은 재부팅될 때까지 어떤 인스턴스에도 적용되지 않습니다.
허용되는 값은 `0`(비활성화: 기본값) 및 `1`(활성화)입니다.
## `UndoLogPurgeConfig`(인스턴스 수준 파라미터)
**`UndoLogPurgeConfig`** - 이 파라미터를 사용하여 Neptune에서 공격적인 UndoLog 제거를 활성화하거나 비활성화합니다.
허용되는 값은 표준 스레드 수를 사용하여 실행 취소 로그를 정리하는 `default`, 증가된 스레드 수를 사용하여 실행 취소 로그의 정리 작업을 가속화하는 `aggressive`입니다. `agressive` 옵션을 선택하면 `NumUndoPagesPurged` 지표에 대한 값이 더 높아질 것으로 예상할 수 있습니다.
## `neptune_enforce_ssl`(더 이상 사용되지 않는 클러스터 수준 파라미터)
(**더 이상 사용되지 않음**) 이전에는 Neptune에 HTTP 연결을 허용하는 리전이 있었는데, 이 파라미터는 1로 설정된 경우 모든 연결에서 HTTPS를 사용하도록 강제하는 데 사용되었습니다. 그러나 Neptune은 이제 모든 리전에서 HTTPS 연결만 허용하므로 이 파라미터는 더 이상 관련이 없습니다.