db. 컬렉션.updateSearchIndex() (mongosh 메서드)

정의

db.collection.updateSearchIndex()

기존 MongoDB Search 인덱스 또는 MongoDB Vector Search 인덱스 업데이트합니다.

호환성

이 메서드는 다음 환경에서 호스팅되는 배포에서 사용할 수 있습니다.

• MongoDB Atlas: The fully managed service for MongoDB deployments in the cloud

• MongoDB Enterprise 버전 8.2 이상을 실행하는 Kubernetes 연산자배포서버

• 버전 이상 실행MongoDB Community 배포 8.2

자체 관리형 배포에 대해 자세히 학습 자체 관리형 배포에 대한 MongoDB 검색을 참조하세요.

구문

명령 구문:

db.<collection>.updateSearchIndex(
   <name>,
   {
      <definition>
   }
)

명령 필드

updateSearchIndex() 는 다음 필드를 사용합니다.

{
   analyzer: "<analyzer-for-index>",
   searchAnalyzer: "<analyzer-for-query>",
   mappings: {
      dynamic: <boolean>,
      fields: { <field-definition> }
   },
   analyzers: [ <custom-analyzer> ],
   storedSource: <boolean> | {
      <stored-source-definition>
   },
   synonyms: [ {
      name: "<synonym-mapping-name>",
      source: {
         collection: "<source-collection-name>"
      },
      analyzer: "<synonym-mapping-analyzer>"
   } ]
}

{
  "fields": [
    {
      "type": "vector" | "filter",
      "path": "<field-to-index>",
      "numDimensions": <number-of-dimensions>,
      "similarity": "euclidean" | "cosine" | "dotProduct"
    }
  ]
}

행동

updateSearchIndex() 새 인덱스 정의로 Atlas Triggers 인덱스 빌드를 합니다. 명령에서 응답을 받는 시점과 업데이트된 인덱스가 준비되는 시점 사이에는 지연이 있을 수 있습니다.

이전 인덱스 정의는 새 인덱스가 작성되는 동안 쿼리를 계속 지원할 수 있습니다. 새 인덱스 작성이 완료되면 이전 인덱스를 더 이상 사용할 수 없습니다. 검색 인덱스의 상태를 확인하려면 $listSearchIndexes 집계 단계를 사용합니다.

액세스 제어

배포서버에서 액세스 제어를 시행하는 경우 updateSearchIndex()를 실행하는 사용자에게 데이터베이스 또는 컬렉션에 대한 updateSearchIndex 권한 조치가 있어야 합니다.

{
   resource: {
      db : <database>,
      collection: <collection>
   },
   actions: [ "updateSearchIndex" ]
}

기본 제공 readWrite 및 restore 역할은 updateSearchIndex 권한을 제공합니다. 다음 예에서는 qa 데이터베이스에 readWrite 역할을 부여합니다.

db.grantRolesToUser(
   "<user>",
   [ { role: "readWrite", db: "qa" } ]
)

예시

다음 예시 새 MongoDB Search 인덱스 생성한 다음 해당 인덱스 업데이트합니다.

1. collection에 이라는 검색 인덱스를 만듭니다.searchIndex01 movies

   db.movies.createSearchIndex(
      "searchIndex01",
      {
         mappings: { dynamic: true },
         storedSource: {
            exclude: [ "imdb.rating" ]
         }
      }
   )

2. searchIndex01 인덱스를 업데이트합니다:

   db.movies.updateSearchIndex(
      "searchIndex01",
      {
         mappings: { dynamic: true },
         storedSource: {
            exclude: [ "movies" ]
         }
      }
   )