SolrClient::addDocument

(PECL solr >= 0.9.2)

SolrClient::addDocument — Añade un documento al índice

Descripción

public SolrClient::addDocument ( SolrInputDocument $doc [, bool $overwrite = TRUE [, int $commitWithin = 0 ]] ) : SolrUpdateResponse

Este método añade un documento al índice.

Parámetros

doc

La instancia de SolrInputDocument.

overwrite

Si sobrescribir el documento existente o no. Si es FALSE existirán duplicados (varios documento con el mismo ID).

Advertencia

En Solr < 2.0 de PECL se usó $allowDups en lugar de $overwrite, que tiene la misma funcionalidad con la bandera booleana opuesta.

$allowDups = false es lo mismo que $overwrite = true

commitWithin

Número de milisegundos dentro de los que autoconsignar este documento. Disponible desde Solr 1.4. El valor predeterminado (0) significa deshabilitado.

Cuando se especifica este valor, deja el control de cúando realizar la consignación al mismo Solr, optimizando el número de consignaciones a un mínimo mientras aún se cumple con los requisitos de latencia de actualizaciones, por lo que Solr realizará automáticamente una consignación cuando la agregación más antigua en el búfer venza.

Valores devueltos

Devuelve un objeto SolrUpdateResponse o lanza una excepción en caso de error.

Errores/Excepciones

Lanza una SolrClientException si el cliente falló o hubo un problema de conexión.

Lanza una SolrServerException si el servidor de Solr falló al procesar la petición.

Ejemplos

Ejemplo #1 Ejemplo de SolrClient::addDocument()

<?php

$opciones = array
(
    'hostname' => SOLR_SERVER_HOSTNAME,
    'login'    => SOLR_SERVER_USERNAME,
    'password' => SOLR_SERVER_PASSWORD,
    'port'     => SOLR_SERVER_PORT,
);

$cliente = new SolrClient($opciones);

$doc = new SolrInputDocument();

$doc->addField('id', 334455);
$doc->addField('cat', 'Software');
$doc->addField('cat', 'Lucene');

$respuestaActualización = $cliente->addDocument($doc);

// se ha de consignar los cambios a escribir is no se usó $commitWithin
$client->commit();

print_r($respuestaActualización->getResponse());

?>

El resultado del ejemplo sería algo similar a:


SolrObject Object
(
    [responseHeader] => SolrObject Object
        (
            [status] => 0
            [QTime] => 1
        )

)

Ejemplo #2 Ejemplo 2 de SolrClient::addDocument()

<?php

$opciones = array
(
    'hostname' => SOLR_SERVER_HOSTNAME,
    'login'    => SOLR_SERVER_USERNAME,
    'password' => SOLR_SERVER_PASSWORD,
    'port'     => SOLR_SERVER_PORT,
);

$cliente = new SolrClient($opciones);

$doc = new SolrInputDocument();

$doc->addField('id', 334455);
$doc->addField('cat', 'Software');
$doc->addField('cat', 'Lucene');

// No es necesario llamar a commit() ya que se proporciona $commitWithin, por lo que Solr Server autoconsignará en 10 segundos
$respuestaActualización = $cliente->addDocument($doc, false, 10000);

print_r($updateResponse->getResponse());

?>

El resultado del ejemplo sería algo similar a:


SolrObject Object
(
    [responseHeader] => SolrObject Object
        (
            [status] => 0
            [QTime] => 1
        )

)

Ver también