Saltar a contenido

Escritura de datos

Versión del paquete: 0.2.1

Esta guía corresponde a tecsci-cloud-api 0.2.1.

Las consultas get_* y list_* leen datos. Las operaciones save_*, post_device_telemetry, set_attributes_*, copy_*, upload_*, backfill_* y las operaciones de administración pueden modificar Tecsci Cloud. Los métodos download_* escriben archivos locales.

Confirmá el destino antes de escribir

Una muestra con la misma entidad, clave y timestamp puede reemplazar un valor existente. Guardar atributos puede sobrescribir las claves indicadas. Las escrituras por lotes pueden completarse parcialmente antes de fallar; no se garantiza una reversión conjunta.

Guardar telemetría y atributos

Este ejemplo define una función, pero no la invoca. Usalo solo con entidades de prueba autorizadas. sensor-001, Demo y todas las mediciones son ficticios.

import os
from tecsci_cloud_python_api import TecsciCloudClient


def guardar_datos_de_prueba():
    with TecsciCloudClient(api_key=os.environ["TECSCI_CLOUD_API_KEY"]) as client:
        client.save_device_telemetry(
            "sensor-001", {"temperature": 21.5, "humidity": 45}
        )
        client.save_device_attributes("sensor-001", {"description": "Demo"})
        client.save_asset_telemetry(
            "Demo", {"temperature": 21.5}, customer_title="Demo"
        )
        activo = client.get_asset("Demo", customer_title="Demo")
        client.save_asset_attributes(activo.id.id, {"description": "Demo"})

Al omitir ts se usa la hora UTC actual en milisegundos. Para muestras históricas, entregá un timestamp explícito. values debe ser un diccionario no vacío con claves de texto no vacías.

save_device_attributes escribe en SERVER_SCOPE. Los métodos por identificador permiten indicar el ámbito. Prestá atención a set_attributes_for_customer_devices: su valor predeterminado es SHARED_SCOPE y afecta a múltiples dispositivos.

Administración e historial

  • rename_devices_by_prefix simula por defecto (dry_run=True).
  • change_customer_devices_profile modifica por defecto (dry_run=False); usá True para revisar primero.
  • copy_device_telemetry_to_asset y upload_asset_telemetry_from_csv pueden sobrescribir puntos existentes.
  • Los métodos backfill_* calculan y guardan diferencias históricas. overwrite=False omite timestamps ya existentes, pero igualmente escribe puntos faltantes; no es una simulación.
  • Los métodos de borrado eliminan alarmas, relaciones o eventos según su propósito.
  • create_customer_users puede enviar correos de activación por defecto.

Revisá los parámetros y errores de cada operación en la referencia. No se ejecutó ninguna escritura real para preparar esta documentación.