Exportaciones CSV¶
Versión del paquete: 0.2.1
Esta guía corresponde a tecsci-cloud-api 0.2.1.
Los dos comandos instalados leen TECSCI_CLOUD_API_KEY del entorno. Consultan Tecsci Cloud y escriben archivos locales; no modifican los datos remotos. Ejecutá primero:
Telemetría por activo¶
El mismo comando funciona en Linux, macOS y PowerShell con el entorno activado:
tecsci-export-telemetry --customer "Demo" --days 7 --asset-type "Demo" --output-dir "exports/demo-telemetria"
| Opción | Uso |
|---|---|
--customer |
Título del cliente; obligatorio. |
--days |
Días de 24 horas hacia atrás desde la ejecución; entero positivo obligatorio. |
--asset-type |
Tipo exacto del activo; predeterminado temp_door. Demo es ficticio. |
--output-dir |
Directorio de destino; predeterminado exports/<cliente>_<tipo>_<dias>d. |
--page-size |
Activos por solicitud; predeterminado 100. |
--page-limit |
Puntos por solicitud de telemetría; predeterminado 10000. |
Se crea el directorio y un CSV por activo del tipo seleccionado. El nombre se deriva del nombre del activo, reemplaza caracteres no admitidos, se limita a 120 caracteres y agrega sufijos si hay colisiones dentro de la exportación. Por ejemplo: exports/demo-telemetria/Demo.csv.
Los CSV usan UTF-8, comas y columnas timestamp (UTC), timestamp_ms y las claves de telemetría ordenadas. Las filas están ordenadas de la más antigua a la más reciente; una medición ausente queda vacía. Un activo sin mediciones genera un archivo con encabezado. Sin activos coincidentes no se generan CSV.
Ejemplo ficticio:
Límites de temperatura¶
tecsci-export-temperature-limits --customer "Demo" --asset-type "Demo" --output "exports/demo-limites.csv"
| Opción | Uso |
|---|---|
--customer |
Título del cliente; obligatorio. |
--asset-type |
Tipo exacto del activo; predeterminado temp_door. |
--scope |
Ámbito de atributos; predeterminado SERVER_SCOPE. |
--output |
Archivo de destino; predeterminado exports/<cliente>_<tipo>_temperature_limits.csv. |
--page-size |
Activos por solicitud; entero positivo, predeterminado 100. |
Exporta los atributos actuales minTemp y maxTemp, no un historial; no admite --days. Crea los directorios necesarios y un CSV con columnas asset_name, asset_id, asset_type, minTemp, maxTemp. Los valores ausentes quedan vacíos. Sin coincidencias escribe solo el encabezado. El resumen informa cuántos valores encontró y, si faltan, qué claves de atributos recibió.
Ambos comandos admiten --base-url; conservá el destino predeterminado de Tecsci Cloud salvo indicación expresa del responsable del servicio. No entregues credenciales a un destino desconocido.
Archivos existentes
Los archivos de destino se abren para escritura y pueden sobrescribirse. Elegí una carpeta nueva para cada exportación. Una falla puede dejar archivos parciales; revisá el resumen y los archivos antes de usarlos.
Los comandos terminan con código 2 si falta la variable; los argumentos inválidos también producen un error de uso. --help no requiere autenticación. No hay una opción de argumento para pasar la API key.