Envío de datos recopilados - OpenSearch - Centro de documentación de Alibaba Cloud

Envía un lote de registros de comportamiento o atributos de usuario a una recopilación de datos en una aplicación de OpenSearch.

Sintaxis de la solicitud

POST /v3/openapi/app-groups/{appName}/data-collections/{dataCollectionName}/data-collection-type/{dataCollectionType}/actions/bulk

Parámetros de ruta

Parámetro	Descripción
`appName`	El nombre de la aplicación de OpenSearch.
`dataCollectionName`	El nombre de la recopilación de datos. De forma predeterminada, corresponde al nombre de la aplicación de OpenSearch.
`dataCollectionType`	El tipo de datos que se envían. Valores válidos: `USER`, `ITEM_INFO`, `BEHAVIOR`, `INDUSTRY_SPECIFIC`.

En la URL anterior se omiten el endpoint y los parámetros del encabezado de la solicitud. Para conocer la estructura completa de la solicitud, consulte Estructura de la solicitud .

Cuerpo de la solicitud

El cuerpo de la solicitud es un arreglo JSON que se pasa como valor del parámetro docs.

Parámetro	Tipo	Obligatorio	Descripción
`docs`	List	Sí	La lista de documentos que se envían.

Cada objeto de documento en la lista docs contiene a continuación los parámetros.

Parámetro	Tipo	Obligatorio	Descripción
`cmd`	String	Sí	La operación por ejecutar. Establezca este valor en `ADD`.
`fields`	Map	Sí	Los campos del documento. El esquema de campos debe coincidir con el tipo de tabla de destino.

Parámetro fields

El valor de fields es un mapa de pares clave-valor cuyas claves deben coincidir con el esquema de la tabla de destino. OpenSearch admite tres tipos de tablas: de usuarios, de elementos y de comportamiento. Para ver las definiciones de campos de cada tipo, consulte Recopilación de datos 2.0.

Elementos de la respuesta

Parámetro	Tipo	Descripción
`errors`	List	Los detalles del error.
`status`	String	El resultado de la solicitud. Valores válidos: `OK` (exitoso), `FAIL` (con errores). Si la solicitud falla, solucione los problemas según el código de error.
`request_id`	String	El ID de la solicitud.
`result`	Boolean	Devuelve `true` cuando la solicitud es exitosa. No se devuelve si la solicitud falla.

Ejemplos

Solicitud

POST /v3/openapi/app-groups/zhao_special/data-collections/zhao_special/data-collection-type/behavior/actions/bulk

[
  {
    "cmd": "ADD",
    "fields": {
        "sdk_type": "opensearch_sdk",
        "sdk_version": "3.2.0",
        "user_id": "10469628",
        "biz_id": 123,
        "trace_id": "231084198510103333",
        "item_id": "id",
        "item_type": "item",
        "bhv_type": "click",
        "reach_time": "20190730105931"
    }
  }
]

Respuesta

{
    "errors": [],
    "request_id": "155084740119723291017595",
    "status": "OK",
    "result": true
}