AI_PARSE_DOCUMENT¶

Syntaxe¶

AI_PARSE_DOCUMENT( '@<stage>', '<path>', [ <options> ] )

Arguments¶

Obligatoire :

stage

Nom de la zone de préparation Snowflake contenant le document à analyser. Il doit s’agir d’une zone de préparation interne ou externe qui utilise un chiffrement côté serveur et qui est accessible à l’utilisateur exécutant la fonction.

path

Chemin relatif vers le document sur la zone de préparation Snowflake.

Facultatif :

options

Une valeur OBJECT qui contient des options en matière d’analyse de documents. Les clés prises en charge sont indiquées ci-dessous. Elles sont toutes facultatives.

• 'mode' : Spécifie le mode d’analyse. Les modes pris en charge sont les suivants :

  • 'OCR' : La fonction extrait uniquement du texte. Il s’agit du mode par défaut.

  • 'LAYOUT' : La fonction extrait la mise en page ainsi que le texte, y compris le contenu structurel tel que les tables.

• 'page_split' : Si définie sur TRUE, la fonction divise le document en pages et traite chaque page séparément. Cette fonctionnalité prend uniquement en charge les documents PDF, PowerPoint (.pptx) et Word (.docx). Les documents dans d’autres formats renvoient une erreur. La valeur par défaut est FALSE.

  Astuce

  Pour traiter des documents longs qui dépassent la limite de jetons de AI_PARSE_DOCUMENT, définissez cette option sur TRUE.

Renvoie¶

Un objet JSON (sous forme de chaîne) contenant les données extraites et les métadonnées associées. L’argument options détermine la structure de l’objet retourné.

Si l’option 'page_split' est définie, la sortie sera dotée de la structure suivante :

• "pages" : Un tableau d’objets JSON, chacun contenant du texte extrait du document. Si le document ne comporte qu’une seule page, la sortie contient toujours un tableau "pages" (qui contient un seul objet). Chaque page comporte les champs suivants :

  • "content" : Texte brut (en mode OCR) ou texte au format Markdown (en mode LAYOUT).

  • "index" : L’index de page dans le fichier, commençant à 0. Les numéros de page et les formats spécifiés dans le document sont ignorés.

• "errorInformation" : Contient des informations d’erreur si le document ne peut pas être analysé.

• "metadata" : Contient des métadonnées sur le document, telles que le nombre de pages.

Note

Les champs "pages" et "metadata" sont présents dans la sortie lorsque l’analyse réussit. "errorInformation" n’est présent que si l’analyse échoue.

Si 'page_split' est FALSE ou n’est pas présent, la sortie sera dotée de la structure suivante :

• "content" : Texte brut (en mode OCR) ou texte au format Markdown (en mode LAYOUT).

• "errorInformation" : Contient des informations d’erreur si le document ne peut pas être analysé.

• "metadata" : Contient des métadonnées sur le document, telles que le nombre de pages.

Note

Les champs "content" et "metadata" sont présents dans la sortie lorsque l’analyse réussit. "errorInformation" n’est présent que si l’analyse échoue.

Exemples¶

Pour des exemples, voir. AI_PARSE_DOCUMENT.