Voordat je begint
- Een Olostep-account met een API-sleutel: krijg er gratis een, geen creditcard vereist. Je eerste 500 credits zijn inbegrepen.
- Een Snowflake-account met externe toegang: de app roept de Olostep API aan via een externe toegangsintegratie, wat proefaccounts niet ondersteunen.
- Een rol die appverbindingen kan goedkeuren: het goedkeuren van de verbinding met
api.olostep.comvereist de bevoegdheidMANAGE APPLICATION SPECIFICATIONS, dieACCOUNTADMINenSECURITYADMINhebben.
Installatie
1
Download de app
Open de vermelding en klik op Downloaden. De voorbeelden op deze pagina gaan ervan uit dat je het installeert als
olostep.2
Keur de verbinding met de Olostep API goed
De app maakt zijn eigen externe toegangsintegratie voor
api.olostep.com, en kan de API niet aanroepen totdat je deze goedkeurt. Ga in Snowsight naar Catalogus > Apps en selecteer de app. Selecteer het Instellingen-icoon, open vervolgens het tabblad Configuraties. Onder Externe verbindingen, breid Details uit naast Externe toegangsintegraties en keur het api.olostep.com eindpunt goed.3
Voeg je API-sleutel toe
Op hetzelfde tabblad Configuraties, onder Referenties, voeg een
GENERIC_STRING geheim toe dat je API-sleutel van het Olostep dashboard bevat aan Olostep API-sleutel.Liever SQL? Doe stappen 2 en 3 in een werkblad
Liever SQL? Doe stappen 2 en 3 in een werkblad
Procedures
Elke procedure retourneert een
VARIANT. Bij falen retourneert het een object met status ingesteld op error. Snelheidslimieten, serverfouten en time-outs worden automatisch opnieuw geprobeerd.
Gebruik
Sla pagina’s op als tabellen
batch_scrape en crawl slaan één rij per pagina op in olostep.results.<table_name>, met de kolommen URL, MARKDOWN, ERROR en RETRIEVED_AT. Het gebruik van een bestaande tabelnaam vervangt die tabel.
id met status ingesteld op in_progress. Sla de pagina’s later op met:
results worden verwijderd als je de app deïnstalleert, dus kopieer alles wat je wilt behouden naar je eigen database.
Problemen oplossen
- “Could not reach api.olostep.com”: de verbinding is nog niet goedgekeurd. Keur het goed zoals in stap 2.
- “Unknown user-defined function INTERNAL.OLOSTEP_REQUEST”: de API-sleutel is nog niet toegevoegd. Voeg het toe zoals in stap 3.
- HTTP 401 in de foutmelding: het geheim bevat geen geldige Olostep API-sleutel. Controleer het in het Olostep dashboard.