Visualização pública: forneça comentários em: Cria um índice no cluster identificado por seu nome de forma contínua.
A construção de índice dessa forma permite a construção de índice em um nó do conjunto de réplicas como um autônomo de cada vez, começando pelos nós secundários. A construção de índice dessa forma requer pelo menos uma eleição de conjunto de réplicas. Para usar este recurso, a chave de API solicitante deve ter a função de administrador de acesso aos dados do projeto.
Este comando é gerado automaticamente e corresponde 1:1 ao endpoint da API do Atlas https://www.mongodb.com/pt-br/docs/atlas/reference/api-resources-spec/v2/#tag/Rolling-Index/operation/createRollingIndex.
Para obter mais informações e exemplos, consulte a documentação da API referenciada acima.
Sintaxe
atlas api rollingIndex createRollingIndex [options]
Opções
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
--clusterName | string | true | Etiqueta legível por humanos que identifica o cluster no qual o MongoDB Cloud cria um índice. |
--envelope | envelope | false | Sinalizador que indica se o aplicativo empacota a resposta em um objeto JSON de envelope. Alguns clientes de API não podem acessar os cabeçalhos de resposta HTTP ou o código de status. Para corrigir isso, defina envelope=true na query. Os endpoints que retornam uma lista de resultados usam o objeto de resultados como um envelope. O aplicativo adiciona o parâmetro de status ao corpo da resposta. |
--file | string | false | caminho para seu arquivo de solicitação de API. Deixe vazio para usar a entrada padrão - você deve fornecer um ou outro, mas não ambos. |
--groupId | string | true | Sequência única de 24dígitos hexadecimais que identifica seu projeto. Use o endpoint [/groups](#tag/Projects/operation/listProjects) para recuperar todos os projetos aos quais o usuário autenticado tem acesso. AVISO: grupos e projetos são termos sinônimos. O ID do seu grupo é igual ao ID do seu projeto. Para grupos existentes, o ID do grupo/projeto permanece o mesmo. O recurso e os endpoints correspondentes usam o termo grupos. |
-h, --help | false | ajuda para createRollingIndex | |
--output | string | false | formato de API preferido, pode ser ["JSON", go-template] Este valor padrão é "JSON". |
--output-file | string | false | no qual gravar a saída da API. Esse sinalizador é necessário quando a saída de um endpoint é binária (por exemplo: gzip) e o comando não é piped (por exemplo: comando atlas > out.zip) |
--pretty | false | Sinalizador que indica se o corpo da resposta deve estar no <a URL =https://en.wikipede.org/wiki/Prettyprint" formato target="_blank" rel="noopener noreferrer">pretty-print</a>. | |
--version | string | false | Versão da API a ser usada ao chamar a chamada da API [opções: "2023-01-01"], o padrão é a versão mais recente ou o valor de configuração dos perfis api_version, se definido Este valor é padronizado como "2023-01a01". |
Opções herdadas
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
-P, --profile | string | false | Nome do perfil a ser usado no arquivo de configuração. Para saber mais sobre perfis para o Atlas CLI, consulte https://dochub.mongodb.org/core/atlas-cli-save-connection-settings. |
Exemplos
Índice parcial
Crie o arquivo abaixo e salve-o como payload.json
{ "collation": { "alternate": "non-ignorable", "backwards": false, "caseFirst": "lower", "caseLevel": false, "locale": "af", "maxVariable": "punct", "normalization": false, "numericOrdering": false, "strength": 3 }, "collection": "accounts", "db": "sample_airbnb", "keys": [ { "property_type": "1" } ], "options": { "name": "PartialIndexTest", "partialFilterExpression": { "limit": { "$gt": 900 } } } }
Após criar o payload.json
, execute o comando abaixo no mesmo diretório.
atlas api rollingIndex createRollingIndex --version 2023-01-01 --file payload.json --clusterName [clusterName] --envelope false --groupId 32b6e34b3d91647abb20e7b8 --pretty false
Sparse Index
Crie o arquivo abaixo e salve-o como payload.json
{ "collation": { "alternate": "non-ignorable", "backwards": false, "caseFirst": "lower", "caseLevel": false, "locale": "af", "maxVariable": "punct", "normalization": false, "numericOrdering": false, "strength": 3 }, "collection": "accounts", "db": "sample_airbnb", "keys": [ { "test_field": "1" } ], "options": { "name": "SparseIndexTest", "sparse": true } }
Após criar o payload.json
, execute o comando abaixo no mesmo diretório.
atlas api rollingIndex createRollingIndex --version 2023-01-01 --file payload.json --clusterName [clusterName] --envelope false --groupId 32b6e34b3d91647abb20e7b8 --pretty false