Avant de commencer
- Un compte Olostep avec une clé API : obtiens-en une gratuitement, sans carte de crédit requise. Tes 500 premiers crédits sont inclus.
- Un compte Snowflake avec accès externe : l’application appelle l’API Olostep via une intégration d’accès externe, que les comptes d’essai ne prennent pas en charge.
- Un rôle pouvant approuver les connexions d’application : l’approbation de la connexion à
api.olostep.comnécessite le privilègeMANAGE APPLICATION SPECIFICATIONS, queACCOUNTADMINetSECURITYADMINpossèdent.
Configuration
1
Obtenir l'application
Ouvre la fiche et clique sur Obtenir. Les exemples sur cette page supposent que tu l’installes sous le nom
olostep.2
Approuver la connexion à l'API Olostep
L’application crée sa propre intégration d’accès externe pour
api.olostep.com, et ne peut pas appeler l’API tant que tu ne l’as pas approuvée. Dans Snowsight, va à Catalogue > Applications et sélectionne l’application. Sélectionne l’icône Paramètres, puis ouvre l’onglet Configurations. Sous Connexions externes, développe Détails à côté de Intégrations d’accès externe et approuve le point de terminaison api.olostep.com.3
Ajouter ta clé API
Dans le même onglet Configurations, sous Identifiants, ajoute un secret
GENERIC_STRING qui contient ta clé API depuis le tableau de bord Olostep à Clé API Olostep.Tu préfères SQL ? Fais les étapes 2 et 3 dans une feuille de calcul
Tu préfères SQL ? Fais les étapes 2 et 3 dans une feuille de calcul
Procédures
Chaque procédure retourne un
VARIANT. En cas d’échec, elle retourne un objet avec status défini sur error. Les limites de taux, erreurs serveur et expirations sont automatiquement réessayées.
Utilisation
Enregistrer les pages en tant que tables
batch_scrape et crawl enregistrent une ligne par page dans olostep.results.<table_name>, avec les colonnes URL, MARKDOWN, ERROR et RETRIEVED_AT. Utiliser un nom de table existant remplace cette table.
id avec status défini sur in_progress. Enregistre ses pages plus tard avec :
results sont supprimées si tu désinstalles l’application, alors copie tout ce que tu veux conserver dans ta propre base de données.
Dépannage
- “Impossible d’atteindre api.olostep.com” : la connexion n’est pas encore approuvée. Approuve-la comme à l’étape 2.
- “Fonction définie par l’utilisateur inconnue INTERNAL.OLOSTEP_REQUEST” : la clé API n’est pas encore ajoutée. Ajoute-la comme à l’étape 3.
- HTTP 401 dans l’erreur : le secret ne contient pas une clé API Olostep valide. Vérifie-la dans le tableau de bord Olostep.