Índices para otimização de queries

Visão geral

Nesta página, você pode ver exemplos de código copiáveis que mostram como gerenciar diferentes tipos de índices usando a Biblioteca PHP do MongoDB .

Para usar um exemplo desta página, copie o exemplo de código no aplicação de amostra ou em seu próprio aplicação. Certifique-se de definir a MONGODB_URI variável de ambiente para a string de conexão de sua implantação do MongoDB e substitua <database> os <collection> espaços reservados e por valores para seu namespace de destino.

1
<?php
2
3
require __DIR__ . '/../vendor/autoload.php';
4
5
$uri = getenv('MONGODB_URI') ?: throw new RuntimeException('Set the MONGODB_URI variable to your Atlas URI that connects to the sample dataset');
6
$client = new MongoDB\Client($uri);
7
8
$collection = $client->selectCollection('<database>', '<collection>');
9
10
// Start example code here
11
12
// End example code here

function toJSON(object $document): string
{
    return MongoDB\BSON\Document::fromPHP($document)->toRelaxedExtendedJSON();
}

Índice de campo único

O exemplo seguinte cria um índice ascendente no campo especificado:

$indexName = $collection->createIndex(['<field name>' => 1]);

Para saber mais sobre índices de campo único, consulte o guia Índices de campo único .

Índice composto

O exemplo seguinte cria um índice composto de dois índices ascendentes nos campos especificados:

$indexName = $collection->createIndex(
    ['<field name 1>' => 1, '<field name 2>' => 1],
);

Para saber mais sobre índices compostos, consulte o guia Índices compostos .

Multikey Index

O exemplo a seguir cria um índice de múltiplas chaves ascendente no campo com valor de array especificado:

$indexName = $collection->createIndex(['<array field name>' => 1]);

Para saber mais sobre índices de várias chaves, consulte o guia Índices de várias chaves.

Índice Geoespacial

O exemplo seguinte cria um índice dsphere 2no campo especificado que tem valores de objeto GeoJSON:

$indexName = $collection->createIndex(
    ['<GeoJSON object field>' => '2dsphere'],
);

Para saber mais sobre o tipo de dados GeoJSON, consulte Objetos GeoJSON no manual do MongoDB Server .

índice único

O exemplo seguinte cria um índice único ascendente no campo especificado:

$indexName = $collection->createIndex(['<field name>' => 1], ['unique' => true]);

Índice curinga

O exemplo seguinte cria um índice curinga ascendente na coleção:

$indexName = $collection->createIndex(['$**' => 1]);

Índices clusterizados

É possível criar um índice clusterizado ao criar uma nova collection em um banco de banco de dados específico. O exemplo seguinte cria uma nova coleção com um índice agrupado ascendente no campo _id :

$options = [
    'clusteredIndex' => [
        'key' => ['_id' => 1],
        'unique' => true,
    ],
];
$database->createCollection('<collection name>', $options);

Text Index

O exemplo seguinte cria um índice de texto no campo de string especificado:

$indexName = $collection->createIndex(['<field name>' => 'text']);

Listar índices

O exemplo a seguir imprime uma lista de índices na coleção especificada:

foreach ($collection->listIndexes() as $indexInfo) {
    echo $indexInfo;
}

Excluir um índice.

O exemplo a seguir exclui um índice com o nome especificado:

$collection->dropIndex('<index name>');

Para saber mais sobre como excluir índices, consulte Remover um índice no guia Considerações e gerenciamento de índices.

Gerenciamento do índice de pesquisa do MongoDB

As seções a seguir contêm exemplos de código que descrevem como gerenciar índice de pesquisa MongoDB e índice de pesquisa vetorial.

Para saber mais sobre os índices de pesquisa do MongoDB, consulte o guia Índices de pesquisa do MongoDB.

$indexName = $collection->createSearchIndex(
    ['mappings' => ['dynamic' => true]],
    ['name' => '<Search index name>'],
);

foreach ($collection->listSearchIndexes() as $indexInfo) {
    echo toJSON($indexInfo), PHP_EOL;
}

$collection->updateSearchIndex(
    '<Search index name>',
    ['mappings' => [
        'dynamic' => false,
        'fields' => [
            '<string field name>' => [
                'type' => 'string',
                'analyzer' => 'lucene.standard',
            ],
        ],
    ]],
);

$collection->dropSearchIndex('<Search index name>');