Conexión Fuente Azure Storage

Requisitos Previos

Antes de configurar la conexión de origen Azure Storage en Crestone, asegúrese de contar con lo siguiente:

Requisito Principal: Una cuenta de Azure Storage activa (Blob Storage) con al menos un contenedor que albergue los archivos que desea extraer. Crestone se conecta mediante la clave de acceso (access key) de la cuenta — no se requiere registro de aplicaciones en Azure AD ni identidades administradas.

Nota: Crestone utiliza directamente el SDK de Azure Storage Blob. No se requieren bibliotecas cliente adicionales ni una puerta de enlace (gateway) local.

Formatos de archivo admitidos:

Otros tipos de archivos (ej. .txt, .zip) no se listan al explorar un contenedor.

Información Requerida:

Consejo: Puede utilizar la misma conexión de Azure Storage tanto para el origen (extracción de archivos) como para el destino (carga de archivos); Crestone los trata como tipos de conexión independientes al crearlos, pero aceptan las mismas credenciales.

---

Paso de Pre-Verificación

Antes de configurar la conexión en Crestone, verifique el nombre de la cuenta y la clave mediante Azure Storage Explorer o el Portal de Azure:

1. En el Portal de Azure, vaya a su Storage Account → Access keys.
2. Confirme que key1 (o key2) esté activa y copie su valor.
3. Abra el Container de destino y confirme que los archivos que desea extraer sean visibles y legibles.

---

Pasos de Configuración

Siga estos pasos para crear una nueva conexión de origen Azure Storage en Crestone:

1. Navegue a Connections en la barra de navegación superior.
2. Seleccione la pestaña Source.
3. Haga clic en el botón + para crear una nueva conexión.
4. Complete el campo Connection Name con un nombre descriptivo (ej. Azure Storage - Reportes).
5. En el menú desplegable Source Type, seleccione Azure Storage.
6. Complete el formulario de credenciales:
   • Account Name — nombre de su cuenta de Azure Storage
   • Account Key — clave de acceso de la cuenta
7. Haga clic en Test Connection para validar que Crestone pueda comunicarse con la cuenta de almacenamiento.
8. Una vez superada la prueba, haga clic en Create Source para guardar la conexión.

---

Edición de una Conexión Existente

Para actualizar las credenciales de una conexión de origen Azure Storage existente:

1. Navegue a Connections y localice su origen Azure Storage.
2. Haga clic en Edit.
3. Modifique los campos deseados en el formulario de credenciales.
4. Haga clic en Test Connection para verificar las nuevas credenciales.
5. Haga clic en Confirm para guardar los cambios.

---

Uso de Azure Storage como Fuente en un Nodo de Extracción

Una vez creada la conexión, puede utilizarla como origen de un Extraction Node. Azure Storage utiliza un modelo de contenedor/archivo — no hay esquemas ni tablas.

1. Abra o cree un Extraction Node y diríjase a la pestaña Source.
2. En Select Source, elija su conexión Azure Storage.
3. En Container, elija el contenedor que alberga el archivo.
4. (Opcional) Utilice el campo Folder / prefix filter para acotar la lista de archivos (ej. data/2026/) y haga clic en Filter.
5. En File, elija el blob/archivo a extraer. Solo se listan los archivos con una extensión admitida.
6. El File format se detecta automáticamente a partir de la extensión del archivo, pero se puede anular:
   • Para CSV/TSV: configure el Delimiter y active/desactive File has header row.
   • Para Excel (.xlsx/.xls): opcionalmente configure el Sheet name (déjelo en blanco para usar la primera hoja).
   • JSON y Parquet no requieren opciones adicionales.
7. La tarjeta de resumen muestra el archivo seleccionado, el formato detectado y las opciones elegidas.
8. El panel de Preview muestra una muestra de los datos que se extraerán.

Nota: Los archivos de Excel se leen con pandas (motor openpyxl para .xlsx, motor xlrd para .xls). Todos los valores de celda se leen como cadenas de texto para evitar problemas de análisis de números y fechas dependientes de la configuración regional; la inferencia de tipos se realiza posteriormente en el destino.

---

Manejo de Tipos de Datos

El manejo de tipos depende del formato del archivo de origen:

Los nombres de columna se sanitizan automáticamente antes de la extracción: los caracteres especiales se reemplazan por _, los nombres no pueden comenzar con un dígito y los nombres duplicados se desambiguan (ej. name, name_1). Esto garantiza la compatibilidad con todos los destinos admitidos (SQL Server, Snowflake, Oracle, etc.).

---

Problemas Frecuentes

---

Permisos Requeridos

La clave de la cuenta de Azure Storage utilizada por Crestone otorga acceso completo de lectura y escritura a la cuenta de almacenamiento de manera predeterminada (es una clave maestra, no una credencial con alcance limitado). Para la extracción de origen, Crestone solo realiza operaciones de lectura (list_containers, list_blobs, download_blob).

Si desea limitar el acceso de Crestone a solo lectura en contenedores específicos, utilice una Firma de Acceso Compartido (SAS) en lugar de la clave de cuenta, con alcance a:

• Servicios permitidos: Blob
• Tipos de recursos permitidos: Contenedor, Objeto
• Permisos permitidos: Lectura, Lista

Nota: Actualmente, el conector de Azure Storage de Crestone no admite tokens SAS; únicamente se admite la autenticación por nombre de cuenta + clave de cuenta. Si requiere un acceso más restringido, cree una cuenta de almacenamiento dedicada para los datos que Crestone extraerá.