método publicar()
Guarda un marco de datos de Pandas o HCL en un conjunto de datos del Centro de Actividad.
Sintaxis
hcl.publish(nombre_marco_de_datos, nombre_tabla = AC_dataset_name, column_names = {"nombre_columna":"nombre_visible_en_marco_de_datos", "...n":"...n"}|dictionary_object, append = True|False)
AC = Centro de Actividades
Parámetros
| Nombre | Descripción |
|---|---|
| nombre_marco_de_datos |
El nombre del marco de datos de Pandas o HCL que se guardará en el Centro de Actividades. Se guardan todas las columnas del marco de datos. Si desea guardar solo una selección de las columnas, cree primero un marco de datos configurado adecuadamente, antes de utilizar publish(). |
| nombre_tabla = AC_dataset_name |
Nombre del conjunto de datos del Centro de Actividad. Nota Revise los nombres de los conjuntos de datos existentes en el Centro de Actividad y asegúrese de especificar un nombre de conjunto de datos que sea único. El método publish() no impide especificar un nombre de conjunto de datos duplicado, lo que puede crear una situación confusa en el Centro de Actividad. |
| column_names = {"nombre_de_columna" : "Nombre_visible_en_marco_de_datos", "...n" : "...n"} opcional |
Una asignación entre un nombre de columna en el marco de datos y un nombre visible para el campo correspondiente en el conjunto de datos del Centro de Actividad. Realice la asignación de una o más columnas con un diccionario estándar de Python. Está especificando un nombre visible solo para el campo en el conjunto de datos del Centro de Actividad de destino. El nombre del campo subyacente en el Centro de Actividad permanece inalterado. Puede elegir especificar nombres para visualizar solo para un subconjunto de columnas. Las columnas sin un nombre visible especificado utilizan el nombre de columna del marco de datos en el Centro de Actividad. El parámetro column_names no selecciona qué columnas se guardan. De manera predeterminada, el método publish() guarda todas las columnas del marco de datos en el Centro de Actividad. Nota Asegúrese de que los nombres de visualización que especifique sean únicos. El método publish() no impide especificar un nombre de visualización duplicado. Sin embargo, la publicación en el Centro de Actividad falla. Si desea obtener más información, consulte Los nombres de columnas y pantallas deben ser únicos. |
| column_names = objeto de diccionario opcional |
Un objeto de diccionario preexistente que asigna uno o más nombres de columna en el marco de datos para mostrar los nombres de los campos correspondientes en el conjunto de datos Centro de actividades. Como alternativa, en lugar de crear la asignación de las columnas en publish(), puede crearla en un diccionario independiente y especificar únicamente el nombre del diccionario dentro de publish(). Si necesita crear el mismo conjunto de nombres de visualización para múltiples conjuntos de datos de destino en el Centro de Actividad, este enfoque es más eficiente. Las directrices que se aplican al crear un diccionario dentro de publish() también se aplican al crear un diccionario independiente. |
| append = True | False |
Si omite el parámetro, los datos guardados sobrescriben de manera predeterminada cualquier dato existente. |
Devuelve
Si el proceso se completa correctamente, el código que se obtiene es 204. Si el proceso no se logra completar, se obtiene un mensaje de error.
El código de retorno 204 significa que Robots ha enviado con éxito los datos al Centro de Actividad. El procesamiento posterior de los datos en el Centro de Actividad también debe tener éxito antes de que los datos enviados desde los Robots estén disponibles como un conjunto de datos en el Centro de Actividad.
Ejemplos
Guardar un marco de datos en un conjunto de datos del Centro de Actividad
Guarde el marco de datos customer_summary (resumen del cliente) en un conjunto de datos del Centro de Actividad denominado Cliente. Si el conjunto de datos Cliente ya existe en el Centro de Actividad, los registros existentes se sobrescriben.
hcl.publish(customer_summary, table_name = "Customer")
Observaciones
Los nombres de columnas y pantallas deben ser únicos
Para publicar correctamente los datos de los Robots en el Centro de Actividad, los nombres de las columnas del marco de datos deben ser únicos. Un nombre de columna duplicado en un marco de datos hace que el método publish() falle con un mensaje de error.
Si especifica nombres de visualización para campos en un conjunto de datos del Centro de Actividad, los nombres de visualización también deben ser únicos. Un nombre de pantalla duplicado no hace que el método publish() falle, y un script que contenga el método se ejecuta hasta completarse. Sin embargo, el procesamiento posterior de los datos falla y la publicación en el Centro de Actividad no se realiza correctamente.
Alcance de la capacidad de publicación
Los permisos de escritura para los conjuntos de datos del Centro de Actividad creados desde Robots están basados en robots. Para actualizar un conjunto de datos, debe utilizar el mismo robot que creó inicialmente el conjunto de datos. El método publish() no permite cruzar los límites de los robots al actualizar los conjuntos de datos.
Adición automática de la fecha y hora de publicación
El método publish() incluye automáticamente la fecha y hora de publicación con los datos enviados al Centro de Actividad. Cuando agregue los datos como una tabla a un análisis y a un cuadro de mando en el Centro de Actividad, incluya el campo Publicado en para mostrar la fecha y hora de publicación más recientes, actualizadas dinámicamente, para cada registro de la tabla.
Esta información de marca de tiempo es útil para verificar que una publicación programada desde Robots se ejecutó en la fecha y hora esperada. Si se agregan registros a un conjunto de datos, la información de fecha y hora también muestra cuándo se agregó cada registro y permite ordenarlos por fecha y hora.
