Índice
-
FirestoreAdmin
(interfaz) -
CreateIndexRequest
(mensaje) -
DeleteIndexRequest
(mensaje) -
ExportDocumentsMetadata
(mensaje) -
ExportDocumentsRequest
(mensaje) -
ExportDocumentsResponse
(mensaje) -
Field
(mensaje) -
Field.IndexConfig
(mensaje) -
FieldOperationMetadata
(mensaje) -
FieldOperationMetadata.IndexConfigDelta
(mensaje) -
FieldOperationMetadata.IndexConfigDelta.ChangeType
(enumeración) -
GetFieldRequest
(mensaje) -
GetIndexRequest
(mensaje) -
ImportDocumentsMetadata
(mensaje) -
ImportDocumentsRequest
(mensaje) -
Index
(mensaje) -
Index.IndexField
(mensaje) -
Index.IndexField.ArrayConfig
(enumeración) -
Index.IndexField.Order
(enumeración) -
Index.QueryScope
(enumeración) -
Index.State
(enumeración) -
IndexOperationMetadata
(mensaje) -
ListFieldsRequest
(mensaje) -
ListFieldsResponse
(mensaje) -
ListIndexesRequest
(mensaje) -
ListIndexesResponse
(mensaje) -
OperationState
(enumeración) -
Progress
(mensaje) -
UpdateFieldRequest
(mensaje)
Administrador de Firestore
Las operaciones las crea el servicio FirestoreAdmin
, pero se accede a ellas a través del servicio google.longrunning.Operations
.
Crear índice |
---|
Crea un índice compuesto. Esto devuelve una
|
Eliminar índice |
---|
Elimina un índice compuesto.
|
Exportar documentos |
---|
Exporta una copia de todos o un subconjunto de documentos de Google Cloud Firestore a otro sistema de almacenamiento, como Google Cloud Storage. Es posible que las actualizaciones recientes de los documentos no se reflejen en la exportación. La exportación se produce en segundo plano y su progreso se puede monitorear y administrar a través del recurso Operación que se crea. El resultado de una exportación sólo podrá utilizarse una vez realizada la operación asociada. Si una operación de exportación se cancela antes de completarse, es posible que queden datos parciales en Google Cloud Storage.
|
Obtener campo |
---|
Obtiene los metadatos y la configuración de un campo.
|
Obtener índice |
---|
Obtiene un índice compuesto.
|
Importar documentos |
---|
Importa documentos a Google Cloud Firestore. Se sobrescriben los documentos existentes con el mismo nombre. La importación se produce en segundo plano y su progreso se puede monitorear y administrar a través del recurso Operación que se crea. Si se cancela una operación ImportDocuments, es posible que ya se haya importado un subconjunto de datos a Cloud Firestore.
|
Lista de campos |
---|
Enumera la configuración de campo y los metadatos de esta base de datos. Actualmente,
|
Lista de índices |
---|
Enumera índices compuestos.
|
Campo de actualización |
---|
Actualiza una configuración de campo. Actualmente, las actualizaciones de campos se aplican solo a la configuración de índice de campo único. Sin embargo, las llamadas a Esta llamada devuelve una Para configurar los ajustes de campo predeterminados para la base de datos, utilice el
|
Crear solicitud de índice
La solicitud de FirestoreAdmin.CreateIndex
.
Campos | |
---|---|
parent | Un nombre principal del formulario |
index | El índice compuesto que se va a crear. |
Eliminar solicitud de índice
La solicitud de FirestoreAdmin.DeleteIndex
.
Campos | |
---|---|
name | Un nombre del formulario |
ExportarDocumentosMetadatos
Metadatos de los resultados de google.longrunning.Operation
de FirestoreAdmin.ExportDocuments
.
Campos | |
---|---|
start_time | La hora en que comenzó esta operación. |
end_time | La hora a la que se completó esta operación. Se desarmará si la operación aún está en progreso. |
operation_state | El estado de la operación de exportación. |
progress_documents | Los avances, en documentos, de esta operación. |
progress_bytes | El progreso, en bytes, de esta operación. |
collection_ids[] | Qué identificadores de colección se están exportando. |
output_uri_prefix | A dónde se exportan las entidades. |
Solicitud de Exportación de Documentos
La solicitud de FirestoreAdmin.ExportDocuments
.
Campos | |
---|---|
name | Base de datos para exportar. Debe tener el formato: |
collection_ids[] | Qué ID de colección exportar. Sin especificar significa todas las colecciones. |
output_uri_prefix | El URI de salida. Actualmente solo admite URI de Google Cloud Storage del formato: |
ExportarDocumentosRespuesta
Devuelto en el campo de respuesta google.longrunning.Operation
.
Campos | |
---|---|
output_uri_prefix | Ubicación de los archivos de salida. Esto se puede usar para comenzar una importación a Cloud Firestore (este proyecto u otro proyecto) después de que la operación se complete exitosamente. |
Campo
Representa un único campo en la base de datos.
Los campos están agrupados por su "Grupo de colecciones", que representa todas las colecciones de la base de datos con la misma identificación.
Campos | |
---|---|
name | Un nombre de campo del formulario Una ruta de campo puede ser un nombre de campo simple, por ejemplo, Las rutas de campo se pueden citar usando Ejemplos: (Nota: los comentarios aquí están escritos en sintaxis de rebajas, por lo que hay una capa adicional de comillas invertidas para representar un bloque de código) Un |
index_config | La configuración del índice para este campo. Si no se establece, la indexación de campos volverá a la configuración definida por el |
Configuración de índice
La configuración del índice para este campo.
Campos | |
---|---|
indexes[] | Los índices admitidos para este campo. |
uses_ancestor_config | Sólo salida. Cuando es verdadero, la configuración del índice del |
ancestor_field | Sólo salida. Especifica el nombre del recurso del |
reverting | Solo salida Cuando es verdadero, la configuración del índice del |
CampoOperaciónMetadatos
Metadatos de los resultados de google.longrunning.Operation
de FirestoreAdmin.UpdateField
.
Campos | |
---|---|
start_time | La hora en que comenzó esta operación. |
end_time | La hora a la que se completó esta operación. Se desarmará si la operación aún está en progreso. |
field | El recurso de campo sobre el que actúa esta operación. Por ejemplo: |
index_config_deltas[] | Una lista de |
state | El estado de la operación. |
document_progress | Los avances, en documentos, de esta operación. |
bytes_progress | El progreso, en bytes, de esta operación. |
ÍndiceConfigDelta
Información sobre un cambio de configuración de índice.
Campos | |
---|---|
change_type | Especifica cómo está cambiando el índice. |
index | El índice está siendo cambiado. |
Tipo de cambio
Especifica cómo está cambiando el índice.
Enumeraciones | |
---|---|
CHANGE_TYPE_UNSPECIFIED | El tipo de cambio no está especificado ni conocido. |
ADD | Se está agregando el índice de campo único. |
REMOVE | Se está eliminando el índice de campo único. |
Obtener solicitud de campo
La solicitud de FirestoreAdmin.GetField
.
Campos | |
---|---|
name | Un nombre del formulario |
Obtener solicitud de índice
La solicitud de FirestoreAdmin.GetIndex
.
Campos | |
---|---|
name | Un nombre del formulario |
ImportarDocumentosMetadatos
Metadatos de los resultados de google.longrunning.Operation
de FirestoreAdmin.ImportDocuments
.
Campos | |
---|---|
start_time | La hora en que comenzó esta operación. |
end_time | La hora a la que se completó esta operación. Se desarmará si la operación aún está en progreso. |
operation_state | El estado de la operación de importación. |
progress_documents | Los avances, en documentos, de esta operación. |
progress_bytes | El progreso, en bytes, de esta operación. |
collection_ids[] | Qué identificadores de colección se están importando. |
input_uri_prefix | La ubicación de los documentos que se importan. |
Solicitud de Importación de Documentos
La solicitud de FirestoreAdmin.ImportDocuments
.
Campos | |
---|---|
name | Base de datos para importar. Debe tener el formato: |
collection_ids[] | Qué ID de colección importar. Sin especificar significa todas las colecciones incluidas en la importación. |
input_uri_prefix | Ubicación de los archivos exportados. Esto debe coincidir con el prefijo_uri_salida de una ExportDocumentsResponse de una exportación que se haya completado correctamente. Consulte: |
Índice
Los índices de Cloud Firestore permiten consultas simples y complejas en documentos en una base de datos.
Campos | |
---|---|
name | Sólo salida. Un nombre definido por el servidor para este índice. La forma de este nombre para índices compuestos será: |
query_scope | Los índices con un alcance de consulta de colección especificado permiten consultas en una colección que es hija de un documento específico, especificada en el momento de la consulta y que tiene el mismo ID de colección. Los índices con un alcance de consulta de grupo de colección especificado permiten consultas en todas las colecciones que descienden de un documento específico, especificadas en el momento de la consulta y que tienen la misma identificación de colección que este índice. |
fields[] | Los campos soportados por este índice. Para índices compuestos, siempre son 2 o más campos. La última entrada de campo es siempre para la ruta del campo Para índices de campo único, siempre será exactamente una entrada con una ruta de campo igual a la ruta del campo asociado. |
state | Sólo salida. El estado de publicación del índice. |
Campo de índice
Un campo en un índice. field_path describe qué campo está indexado, value_mode describe cómo se indexa el valor del campo.
Campos | |
---|---|
field_path | Puede ser nombre . Para índices de campo único, esto debe coincidir con el nombre del campo o puede omitirse. |
Campo de unión value_mode . Cómo se indexa el valor del campo. value_mode puede ser solo uno de los siguientes: | |
order | Indica que este campo admite ordenar según el orden especificado o comparar usando =, <, <=, >, >=. |
array_config | Indica que este campo admite operaciones en |
configuración de matriz
Las configuraciones de valores de matriz admitidas.
Enumeraciones | |
---|---|
ARRAY_CONFIG_UNSPECIFIED | El índice no admite consultas de matriz adicionales. |
CONTAINS | El índice admite consultas de contención de matrices. |
Orden
Los pedidos admitidos.
Enumeraciones | |
---|---|
ORDER_UNSPECIFIED | El orden no está especificado. No es una opción válida. |
ASCENDING | El campo está ordenado por valor de campo ascendente. |
DESCENDING | El campo está ordenado por valor de campo descendente. |
Alcance de consulta
Query Scope define el alcance en el que se ejecuta una consulta. Esto se especifica en el campo from
de StructuredQuery.
Enumeraciones | |
---|---|
QUERY_SCOPE_UNSPECIFIED | El alcance de la consulta no está especificado. No es una opción válida. |
COLLECTION | Los índices con un alcance de consulta de colección especificado permiten consultas en una colección que es hija de un documento específico, especificada en el momento de la consulta y que tiene la identificación de colección especificada por el índice. |
COLLECTION_GROUP | Los índices con un alcance de consulta de grupo de colección especificado permiten consultas en todas las colecciones que tienen la identificación de colección especificada por el índice. |
Estado
El estado de un índice. Durante la creación del índice, un índice estará en el estado CREATING
. Si el índice se crea correctamente, pasará al estado READY
. Si la creación del índice encuentra un problema, el índice pasará al estado NEEDS_REPAIR
.
Enumeraciones | |
---|---|
STATE_UNSPECIFIED | El estado no se especifica. |
CREATING | El índice se está creando. Hay una operación activa de larga duración para el índice. El índice se actualiza al escribir un documento. Es posible que existan algunos datos de índice. |
READY | El índice está listo para ser utilizado. El índice se actualiza al escribir un documento. El índice se completa completamente con todos los documentos almacenados a los que se aplica. |
NEEDS_REPAIR | Se estaba creando el índice, pero algo salió mal. No hay ninguna operación activa de larga duración para el índice y la operación de larga duración finalizada más recientemente falló. El índice no se actualiza al escribir un documento. Es posible que existan algunos datos de índice. Utilice la API google.longrunning.Operations para determinar por qué falló la última operación que intentó crear este índice y luego vuelva a crear el índice. |
OperaciónÍndiceMetadatos
Metadatos de los resultados de google.longrunning.Operation
de FirestoreAdmin.CreateIndex
.
Campos | |
---|---|
start_time | La hora en que comenzó esta operación. |
end_time | La hora a la que se completó esta operación. Se desarmará si la operación aún está en progreso. |
index | El recurso de índice sobre el que actúa esta operación. Por ejemplo: |
state | El estado de la operación. |
progress_documents | Los avances, en documentos, de esta operación. |
progress_bytes | El progreso, en bytes, de esta operación. |
Solicitud de campos de lista
La solicitud de FirestoreAdmin.ListFields
.
Campos | |
---|---|
parent | Un nombre principal del formulario |
filter | El filtro que se aplicará a los resultados de la lista. Actualmente, |
page_size | El número de resultados que se devolverán. |
page_token | Un token de página, devuelto por una llamada anterior a |
ListaCamposRespuesta
La respuesta para FirestoreAdmin.ListFields
.
Campos | |
---|---|
fields[] | Los campos solicitados. |
next_page_token | Un token de página que se puede utilizar para solicitar otra página de resultados. Si está en blanco, esta es la última página. |
Solicitud de índices de lista
La solicitud de FirestoreAdmin.ListIndexes
.
Campos | |
---|---|
parent | Un nombre principal del formulario |
filter | El filtro que se aplicará a los resultados de la lista. |
page_size | El número de resultados que se devolverán. |
page_token | Un token de página, devuelto por una llamada anterior a |
ListaÍndicesRespuesta
La respuesta para FirestoreAdmin.ListIndexes
.
Campos | |
---|---|
indexes[] | Los índices solicitados. |
next_page_token | Un token de página que se puede utilizar para solicitar otra página de resultados. Si está en blanco, esta es la última página. |
EstadoOperación
Describe el estado de la operación.
Enumeraciones | |
---|---|
OPERATION_STATE_UNSPECIFIED | Sin especificar. |
INITIALIZING | La solicitud se está preparando para su procesamiento. |
PROCESSING | La solicitud se está procesando activamente. |
CANCELLING | La solicitud está en proceso de cancelación después de que el usuario llamó a google.longrunning.Operations.CancelOperation en la operación. |
FINALIZING | La solicitud ha sido procesada y se encuentra en su etapa de finalización. |
SUCCESSFUL | La solicitud se ha completado con éxito. |
FAILED | La solicitud terminó de procesarse, pero se produjo un error. |
CANCELLED | La solicitud terminó de cancelarse después de que el usuario llamara a google.longrunning.Operations.CancelOperation. |
Progreso
Describe el progreso de la operación. La unidad de trabajo es genérica y debe interpretarse en función de dónde se utiliza Progress
.
Campos | |
---|---|
estimated_work | La cantidad de trabajo estimada. |
completed_work | La cantidad de trabajo completado. |
Solicitud de campo de actualización
La solicitud de FirestoreAdmin.UpdateField
.
Campos | |
---|---|
field | El campo a actualizar. |
update_mask | Una máscara, relativa al campo. Si se especifica, solo se actualizará en el campo la configuración especificada por esta máscara de campo. |