동일한 디자인 문서 내의 여러 뷰

동일한 디자인 문서에서 여러 뷰를 정의하면, 이들은 효율적으로 동시에 빌드됩니다. 각 문서는 한 번만 읽힌 후 각 뷰의 map 함수를 거칩니다. 이 접근법을 사용하는 경우 디자인 문서 수정 시 해당 문서에 정의된 기존의 모든 MapReduce 보기가 무효화된다는 점을 기억하십시오. 이 프로세스는 일부 보기가 변경되지 않은 상태로 유지되는 경우에도 MapReduce 보기를 무효화합니다.

MapReduce 뷰를 개별적으로 변경해야 하는 경우에는 이들의 정의를 각각 별도의 디자인 문서에 배치하십시오.

이 동작은 Lucene 검색 인덱스에는 적용되지 않습니다. 이들은 동일한 디자인 문서에 있는 다른 변경되지 않은 인덱스를 무효화시키지 않으면서 변경될 수 있습니다.

디자인 문서에 대한 변경사항 관리

미래의 한 시점에 뷰의 디자인을 변경하기로 결정했다고 가정해 보십시오. 이제는 실제 시간소인 결과를 리턴하는 대신 기준과 일치하는 문서의 개수에만 관심이 있습니다. 이 개수를 얻기 위해, map 함수는 그대로 두고 reduce라는 _count 함수를 사용합니다.

다음과 같이 reduce 함수를 사용하는 디자인 문서 예제를 참조하십시오.

{
    "_id": "_design/fetch",
    "_rev": "2-a2324c9e74a76d2a16179c56f5315dba",
    "views": {
        "by_ts": {
            "map": "function(doc) {
                if (doc.ts) {
                  emit( doc.ts, null);
                }
            }
        }",
        "reduce": "_count"
    },
    "language": "javascript"
}

이 디자인 문서가 저장될 때 IBM Cloudant에서는 이전 인덱스를 완전히 무효화하고 처음부터 새 인덱스 빌드를 시작하며, 차례로 모든 문서를 반복합니다. 원래 빌드와 마찬가지로, 소요되는 시간은 데이터베이스에 있는 문서의 수에 따라 달라집니다. 빌드는 또한 완료될 때까지 해당 뷰에 대한 수신 조회를 차단합니다.

그러나 여기에는 문제점이 있습니다.

실시간으로 이 보기에 액세스하는 애플리케이션이 존재하는 경우 배치 딜레마가 발생할 수 있습니다.

• 이전 뷰가 무효화되었으므로 원래 디자인 문서에 의존하던 코드 버전 1이 더 이상 작동하지 않을 수 있습니다.
• 코드 버전 2는 새 디자인 문서를 사용합니다. 새 보기의 빌드가 아직 완료되지 않았기 때문에 이 버전을 즉시 릴리스할 수 없습니다. 데이터베이스에 대량의 문서가 포함되어 있는 경우 빌드 프로세스에 더 많은 시간이 소요된다는 점을 기억하십시오.
• 코드에 영향을 미치는 더 미묘한 문제는 버전 1과 2가 뷰에서 서로 다른 결과 데이터를 예상한다는 점입니다. 버전 1은 일치하는 문서 목록을 예상하는 반면, 버전 2는 '감소된' 결과 수를 예상합니다.

디자인 문서에 대한 변경사항 조율

이 변경 제어 문제점은 두 가지 방법으로 해결할 수 있습니다.

Move and switch 도구

명령행 Node.js couchmigrate 스크립트는 Move and switch 프로시저를 자동화합니다. 이 스크립트는 다음 명령을 사용하여 설치할 수 있습니다.

npm install -g couchmigrate

To use the couchmigrate script, first define the URL of the CouchDB/IBM Cloudant instance by setting an environment variable called COUCH_URL. IBM Cloudant 인스턴스의 URL을 정의하려면 다음 명령을 실행하십시오.

export COUCH_URL=https://127.0.0.1:5984

URL은 https:// 시작해야 하며 인증 자격 증명을 포함할 수 있습니다. 인증용 인증 정보를 포함하는 IBM Cloudant 인스턴스의 URL을 정의하려면 다음 명령을 실행하십시오.

export COUCH_URL="https://$ACCOUNT:$PASSWORD@$HOST.cloudant.com"

파일에 저장된 JSON 형식의 디자인 문서가 있는 경우에는 마이그레이션 명령을 실행할 수 있습니다.

이 예에서, db specifies the name of the database to change, and dd specifies the path to the design document file. couchmigrate 명령을 실행하십시오.

couchmigrate --db mydb --dd /path/to/my/dd.json

이 스크립트는 Move and switch 프로시저를 조율하며 리턴하기 전에 뷰가 빌드되기를 기다립니다. 수신 디자인 문서가 현재 디자인 문서와 동일한 경우에는 스크립트가 거의 즉시 리턴됩니다.

이 스크립트의 소스 코드는 다음에서 사용 가능합니다. couchmigrate.

'stale' 매개변수

인덱스가 완료된 상태에서 새 레코드가 데이터베이스에 추가되면 인덱스가 백그라운드에서 업데이트되도록 스케줄됩니다. 데이터베이스의 상태는 다음 다이어그램에 표시되어 있습니다.

보기를 조회하는 경우 다음과 같은 선택사항이 존재합니다.

• 기본 동작은 응답을 리턴하기 전에 인덱스가 데이터베이스의 최신 문서에 대해 최신 상태가 되도록 하는 것입니다. 뷰를 쿼리할 때 IBM Cloudant에서는 먼저 250개의 새 문서를 색인화한 후 응답을 리턴합니다.
• 대체 방법은 stale=ok 매개변수를 API 호출에 추가하는 것입니다. 이 매개변수는 다음을 의미합니다. return me the data that is already indexed. I don't care about the latest updates. In other words, when you query the view with stale=ok, IBM Cloudant에서 추가 재색인화 없이 즉시 응답을 리턴합니다.
• 두 번째 대체 방법은 stale=update_after 매개변수를 API 호출에 추가하는 것입니다. 이 매개변수는 다음을 의미합니다. return me the data that is already indexed, and then reindex any new documents. In other words, when you query the view with stale=update_after, IBM Cloudant에서 응답을 즉시 리턴한 후 백그라운드 태스크를 스케줄하여 새 데이터를 인덱스화합니다.

stale=ok 또는 stale=update_after를 추가하는 것은 뷰로부터 응답을 더 빨리 받는 좋은 방법이지만 데이터가 최신 상태가 아닐 수 있습니다.

기본 동작은 IBM Cloudant 클러스터에 속한 노드 전체에 로드를 균등하게 분배하는 것입니다. 대체 방법인 stale=ok 또는 stale=update_after 옵션을 사용하면 결과적으로 일관된 세트로부터 일관된 결과를 리턴하기 위해 클러스터 노드의 특정 서브세트에 로드가 집중될 수 있습니다. stale 매개변수가 모든 유스 케이스에 대한 완벽한 해결책은 아닙니다. 그러나 애플리케이션에서 시간이 경과된(stale) 결과를 수신해도 괜찮은 경우에는 이를 통해 빠르게 변경되는 데이터 세트에 대해 적시에 응답을 제공받을 수 있습니다. 데이터의 변경 속도가 느린 경우에는 stale=ok 또는 stale=update_after를 추가해도 성능 이점이 없을 수 있으며, 대규모 클러스터에서 로드가 균등하지 않게 분배될 수 있습니다.

기본 동작에서 최신 데이터를 제공하고 클러스터 내에서 데이터를 분배하므로 가능한 경우 stale=ok 또는 stale=update_after를 사용하지 마십시오. 이 시간 중에 임시로 stale=ok로 전환하여 클라이언트 앱에 대량의 데이터 처리 태스크(예: 정기적인 대량 데이터 업데이트)가 진행 중인지 감지하도록 할 수 있습니다. 그리고 태스크가 완료되고 나면 기본 동작으로 되돌아 갈 수 있습니다.

stale 옵션은 여전히 사용할 수 있지만 더 유용한 옵션인 stable과 update가 사용 가능하며 필요한 경우에는 이들을 대신 사용해야 합니다. 자세한 정보는 시간이 경과된(stale) 뷰에 액세스를 참조하십시오.