기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Amazon MQ 하위 요소 속성
<a name="child-element-details"></a>

다음은 하위 요소 속성에 대한 자세한 설명입니다. 자세한 내용은 Apache ActiveMQ 설명서의 [XML 구성](http://activemq.apache.org/xml-configuration.html)을 참조하세요.

**Topics**
+ [authorizationEntry](#authorizationEntry)
+ [networkConnector](#networkConnector)
+ [kahaDB](#kahaDB)
+ [systemUsage](#systemUsage)

## authorizationEntry
<a name="authorizationEntry"></a>

`authorizationEntry`는 `authorizationEntries` 하위 컬렉션 요소의 하위입니다.

### 속성
<a name="admin-read-write-attributes"></a>

#### admin\|read\|write
<a name="admin-read-write"></a>

사용자 그룹에게 부여된 권한. 자세한 정보는 [항상 권한 부여 맵 구성](using-amazon-mq-securely.md#always-configure-authorization-map)을 참조하세요.

`activemq-webconsole` 그룹을 포함하지 않는 권한 부여 맵을 지정하는 경우, 그룹이 Amazon MQ 브로커에 메시지를 보내거나 브로커에서 메시지를 수신할 권한이 없기 때문에 ActiveMQ 웹 콘솔을 사용할 수 없습니다.

**기본값**: `null`

### 구성의 예제
<a name="admin-read-write-example"></a>

```
<authorizationPlugin>
                                <map>
                                    <authorizationMap>
                                        <authorizationEntries>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" queue=">"/>
                                            <authorizationEntry admin="admins,activemq-webconsole" read="admins,users,activemq-webconsole" write="admins,activemq-webconsole" topic=">"/>
                                        </authorizationEntries>
                                    </authorizationMap>
                                </map>
                                </authorizationPlugin>
```

**참고**  
 Amazon MQ 기반 ActiveMQ의 `activemq-webconsole` 그룹은 모든 대기열 및 주제에 대한 관리자 권한을 보유하고 있습니다. 이 그룹의 모든 사용자도 관리자 액세스 권한을 갖습니다.

## networkConnector
<a name="networkConnector"></a>

`networkConnector`는 `networkConnectors` 하위 컬렉션 요소의 하위입니다.

**Topics**
+ [속성](#networkConnector-attributes)
+ [구성의 예](#networkConnector-example)

### 속성
<a name="networkConnector-attributes"></a>

#### conduitSubscriptions
<a name="conduitSubscriptions"></a>

브로커 네트워크 내 네트워크 연결이 동일한 대상에 구독하는 여러 소비자를 한 소비자로 취급하는지 여부를 지정합니다. 예를 들어 `conduitSubscriptions`가 `true`로 설정되고 두 소비자가 브로커 B에 연결하여 대상으로부터 소비할 경우, 브로커 B는 이들의 구독을 네트워크 연결을 통한 브로커 A에 대한 단일의 논리적 구독으로 결합합니다. 그러므로 메시지의 단일 복사본만 브로커 A에서 브로커 B로 전달됩니다.

**참고**  
`conduitSubscriptions`를 `true`로 설정하면 중복 네트워크 트래픽을 줄일 수 있습니다. 하지만 이 속성을 사용하면 소비자 사이의 로드 밸런싱 문제가 발생할 수 있고 일부 시나리오(예: JMS 메시지 선택기 또는 장기적 주제)에서 잘못된 동작을 초래할 수 있습니다.

**기본값**: `true`

#### duplex
<a name="duplex"></a>

브로커 네트워크 내 연결이 메시지를 생산 *및* 소비하는 데 사용되는지 여부를 지정합니다. 예를 들어 브로커 A가 비 전이중 모드로 브로커 B와의 연결을 생성한 경우 메시지는 브로커 A에서 브로커 B로만 전달될 수 있습니다. 하지만 브로커 A가 브로커 B와 전이중 연결을 생성한 경우에는 브로커 B가 `<networkConnector>`를 구성할 필요 없이 브로커 A로 메시지를 전달할 수 있습니다.

**기본값**: `false`

#### 이름
<a name="name"></a>

브로커 네트워크 내 브리지의 이름.

**기본값**: `bridge`

#### uri
<a name="uri"></a>

브로커 네트워크를 구성하는 두 브로커 중 하나(또는 여러 브로커)의 와이어 레벨 프로토콜 엔드포인트.

**기본값**: `null`

#### 사용자 이름
<a name="username"></a>

브로커 네트워크의 브로커에 공통된 사용자 이름.

**기본값**: `null`

### 구성의 예
<a name="networkConnector-example"></a>

**참고**  
`networkConnector`를 사용하여 브로커 네트워크를 정의할 때 브로커에 공통된 사용자의 암호를 포함시키지 마세요.

#### 2개 브로커로 구성된 브로커 네트워크
<a name="example-network-of-brokers-two-brokers"></a>

이 구성에서는 2개의 브로커가 브로커 네트워크로 연결되어 있습니다. 네트워크 커넥터의 이름은 `connector_1_to_2`이고, 브로커에 공통된 사용자 이름은 `myCommonUser`이고, 연결은 `duplex`이고, OpenWire 엔드포인트 URI는 접두사 `static:`을 사용하여 브로커 간 일대일 연결을 나타냅니다.

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="static:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

자세한 정보는 [2단계: 브로커에 대한 네트워크 커넥터 구성](amazon-mq-creating-configuring-network-of-brokers.md#creating-configuring-network-of-brokers-configure-network-connectors)을 참조하세요.

#### 여러 브로커로 구성된 브로커 네트워크
<a name="example-network-of-brokers-multiple-brokers"></a>

이 구성에서는 여러 개의 브로커가 브로커 네트워크로 연결되어 있습니다. 네트워크 커넥터의 이름은 `connector_1_to_2`이고, 브로커에 공통된 사용자 이름은 `myCommonUser`이며, 연결은 `duplex`이고, OpenWire 엔드포인트 URI의 쉼표로 구분된 목록은 접두사 `masterslave:`을 사용하여 브로커 간 장애 조치 연결을 나타냅니다. 브로커 간 장애 조치는 랜덤화되지 않으며 재연결 시도가 무한정 계속됩니다.

```
<networkConnectors>
                                    <networkConnector name="connector_1_to_2" userName="myCommonUser" duplex="true"
                                        uri="masterslave:(ssl://b-1234a5b6-78cd-901e-2fgh-3i45j6k178l9-1.mq.us-east-2.amazonaws.com:61617,
                                        ssl://b-9876l5k4-32ji-109h-8gfe-7d65c4b132a1-2.mq.us-west-2.amazonaws.com:61617)"/>
                                    </networkConnectors>
```

**참고**  
브로커 네트워크에는 `masterslave:` 접두사를 사용하는 것이 좋습니다. 이 접두사는 더 명시적인 `static:failover:()?randomize=false&maxReconnectAttempts=0` 구문과 동일합니다.

**참고**  
이 XML 구성에는 공백이 허용되지 않습니다.

## kahaDB
<a name="kahaDB"></a>

`kahaDB`는 `persistenceAdapter` 하위 컬렉션 요소의 하위입니다.

### 속성
<a name="kahaDB-attributes"></a>

#### concurrentStoreAndDispatchQueues
<a name="concurrentStoreAndDispatchQueues"></a>

대기열에 동시 저장 및 디스패치를 사용할지 여부를 지정합니다. 자세한 정보는 [느린 소비자를 통해 대기열 동시 저장 및 디스패치 비활성화](best-practices-activemq.md#disable-concurrent-store-and-dispatch-queues-flag-slow-consumers)을 참조하세요.

**기본값**: `true`

#### cleanupOnStop
<a name="cleanupOnStop"></a>

**지원 버전:**  
Apache ActiveMQ 15.16.x 이상

비활성화된 경우 브로커가 중지될 때 가비지 수집 및 정리가 수행되지 않으므로 종료 프로세스가 빨라집니다. 속도가 증가하면 대형 데이터베이스 또는 스케줄러 데이터베이스인 경우 유용합니다.

**기본값**: `true`

#### journalDiskSyncInterval
<a name="journalDiskSyncInterval"></a>

`journalDiskSyncStrategy=periodic`의 경우 디스크 동기화를 수행할 때의 간격(ms)입니다. 자세한 내용은 [Apache ActiveMQ kahaDB 설명서](https://activemq.apache.org/kahadb)를 참조하세요.

**기본값**: `1000`

#### journalDiskSyncStrategy
<a name="journalDiskSyncStrategy"></a>

**지원 버전:**  
Apache ActiveMQ 15.14.x 이상

디스크 동기화 정책을 구성합니다. 자세한 내용은 [Apache ActiveMQ kahaDB 설명서](https://activemq.apache.org/kahadb)를 참조하세요.

**기본값**: `always`

**참고**  
[ActiveMQ 설명서](https://activemq.apache.org/kahadb)에는 데이터 손실이 `journalDiskSyncInterval`의 시간으로 제한된다고 기술되어 있습니다. 즉, 기본값은 1초입니다. 데이터 손실은 해당 간격보다 길 수는 있지만 정확하게 명시하기는 어렵습니다. 사용 시 주의해야 합니다.

#### preallocationStrategy
<a name="preallocationStrategy"></a>

새 저널 파일이 필요한 경우 브로커가 저널 파일을 미리 할당하는 방법을 구성합니다. 자세한 내용은 [Apache ActiveMQ kahaDB 설명서](https://activemq.apache.org/kahadb)를 참조하세요.

**기본값**: `sparse_file`

### 구성의 예제
<a name="kahaDB-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <persistenceAdapter>
                                <kahaDB preallocationStrategy="zeros" concurrentStoreAndDispatchQueues="false" journalDiskSyncInterval="10000" journalDiskSyncStrategy="periodic"/>
                            </persistenceAdapter>
                            </broker>
```

## systemUsage
<a name="systemUsage"></a>

`systemUsage`는 `systemUsage` 하위 컬렉션 요소의 하위입니다. 생산자 속도가 느려지기 전에 브로커가 사용할 최대 공간을 제어합니다. 자세한 내용은 Apache ActiveMQ 설명서의 [생산자 흐름 제어](http://activemq.apache.org/producer-flow-control.html)를 참조하세요.

### 하위 요소
<a name="systemUsage-child"></a>

#### memoryUsage
<a name="memoryUsage"></a>

 `memoryUsage`는 `systemUsage` 하위 요소의 하위입니다. 메모리 사용량을 관리합니다. `memoryUsage`를 이용하면 항목이 얼마나 많이 사용되고 있는지 계속 추적할 수 있으므로 작업 세트 사용을 생산적으로 제어할 수 있습니다. 자세한 내용은 Apache Active MQ 설명서의 [스키마](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html)를 참조하세요.

##### 하위 요소
<a name="memoryUsage-child"></a>

 `memoryUsage`는 `memoryUsage` 하위 요소의 하위입니다.

##### 속성
<a name="memeoryUsage-attribute"></a>

##### percentOfJvmHeap
<a name="percentOfJvmHeap"></a>

0(포함)에서 70(포함) 사이의 정수입니다.

*기본값*: `70` 

### 속성
<a name="systemUsage-attributes"></a>

#### sendFailIfNoSpace
<a name="sendFailIfNoSpace"></a>

여유 공간이 없는 경우 `send()` 메서드가 실패할지 여부를 설정합니다. 기본값은 false이며 공간을 사용할 수 있을 때까지 `send()` 메서드를 차단합니다. 자세한 내용은 Apache Active MQ 설명서의 [스키마](http://activemq.apache.org/schema/core/activemq-core-5.15.12-schema.html)를 참조하세요.

**기본값**: `false`

#### sendFailIfNoSpaceAfterTimeout
<a name="sendFailIfNoSpaceAfterTimeout"></a>

**기본값**: `null`

#### 구성의 예제
<a name="systemUsage-example"></a>

**Example**  

```
<broker xmlns="http://activemq.apache.org/schema/core">
                                <systemUsage>
                                <systemUsage sendFailIfNoSpace="true" sendFailIfNoSpaceAfterTimeout="2000">
                                    <memoryUsage>
                                        <memoryUsage  percentOfJvmHeap="60" />
                                    </memoryUsage>>
                                </systemUsage>
                                </systemUsage>
                            </broker>
                            </persistenceAdapter>
```