Antes de comenzar
- Una cuenta de Olostep con una clave API: obtén una gratis, no se requiere tarjeta de crédito. Tus primeros 500 créditos están incluidos.
- Una cuenta de Snowflake con acceso externo: la aplicación llama a la API de Olostep a través de una integración de acceso externo, que las cuentas de prueba no soportan.
- Un rol que pueda aprobar conexiones de aplicaciones: aprobar la conexión a
api.olostep.comrequiere el privilegioMANAGE APPLICATION SPECIFICATIONS, que tienenACCOUNTADMINySECURITYADMIN.
Configuración
1
Obtén la aplicación
Abre la lista y haz clic en Obtener. Los ejemplos en esta página asumen que la instalas como
olostep.2
Aprueba la conexión a la API de Olostep
La aplicación crea su propia integración de acceso externo para
api.olostep.com, y no puede llamar a la API hasta que la apruebes. En Snowsight, ve a Catálogo > Aplicaciones y selecciona la aplicación. Selecciona el icono de Configuraciones, luego abre la pestaña de Configuraciones. Bajo Conexiones externas, expande Detalles junto a Integraciones de acceso externo y aprueba el endpoint api.olostep.com.3
Agrega tu clave API
En la misma pestaña de Configuraciones, bajo Credenciales, agrega un secreto
GENERIC_STRING que contenga tu clave API desde el dashboard de Olostep a Clave API de Olostep.¿Prefieres SQL? Realiza los pasos 2 y 3 en una hoja de trabajo
¿Prefieres SQL? Realiza los pasos 2 y 3 en una hoja de trabajo
Procedimientos
Cada procedimiento devuelve un
VARIANT. En caso de fallo, devuelve un objeto con status establecido en error. Los límites de velocidad, errores del servidor y tiempos de espera se reintentan automáticamente.
Uso
Guarda páginas como tablas
batch_scrape y crawl guardan una fila por página en olostep.results.<table_name>, con las columnas URL, MARKDOWN, ERROR y RETRIEVED_AT. Usar un nombre de tabla existente reemplaza esa tabla.
id con status establecido en in_progress. Guarda sus páginas más tarde con:
results se eliminan si desinstalas la aplicación, así que copia cualquier cosa que quieras conservar en tu propia base de datos.
Solución de problemas
- “No se pudo alcanzar api.olostep.com”: la conexión aún no está aprobada. Apruébala como en el paso 2.
- “Función definida por el usuario desconocida INTERNAL.OLOSTEP_REQUEST”: la clave API aún no está agregada. Agrégala como en el paso 3.
- HTTP 401 en el error: el secreto no contiene una clave API de Olostep válida. Revísala en el dashboard de Olostep.