AI_PARSE_DOCUMENT¶

Syntax¶

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

Argumente¶

Benötigt:

stage

Name des Snowflake-Stagingbereichs, der das zu parsende Dokument enthält. Dies muss ein interner oder externer Stagingbereich sein, der serverseitige Verschlüsselung verwendet und für den Benutzer, der die Funktion ausführt, zugänglich ist.

path

Relativer Pfad zu dem Dokument im Snowflake-Stagingbereich.

Optional:

options

Ein OBJECT-Wert, der Optionen für das Parsen von -Dokumenten enthält. Die unterstützten Schlüssel sind unten aufgeführt. Alle sind optional.

• 'mode': Gibt den Parsing-Modus an. Folgende Modi werden unterstützt:

  • 'OCR': Die Funktion extrahiert nur Text. Dies ist der Standardmodus.

  • 'LAYOUT': Die Funktion extrahiert sowohl das Layout als auch Text, einschließlich struktureller Inhalte wie Tabellen.

• 'page_split': Wenn auf TRUE gesetzt, teilt die Funktion das Dokument in Seiten auf und verarbeitet jede Seite separat. Dieses Feature unterstützt nur Dokumente im PDF-, PowerPoint (.pptx)- und Word (.docx)-Format. Dokumente in anderen Formaten geben einen Fehler zurück. Der Standardwert ist FALSE.

  Tipp

  Zum Verarbeiten von langen Dokumenten, die die Token-Limit von AI_PARSE_DOCUMENT überschreiten, setzen Sie diese Option auf TRUE.

Rückgabewerte¶

Ein JSON-Objekt (als Zeichenfolge), das die extrahierten Daten und die zugehörigen Metadaten enthält. Das options-Argument bestimmt die Struktur des zurückgegebenen Objekts.

Wenn die 'page_split'-Option festgelegt ist, hat die Ausgabe die folgende Struktur:

• "pages": Ein Array von JSON-Objekten, die jeweils Text enthalten, der aus dem Dokument extrahiert wurde. Wenn das Dokument nur eine Seite hat, enthält die Ausgabe trotzdem ein "pages"-Array (das ein einzelnes Objekt enthält). Jede Seite hat die folgenden Felder:

  • "content": Klartext (im OCR-Modus) oder Markdown-formatierter Text (im LAYOUT-Modus).

  • "index": Der Seitenindex in der Datei, beginnend bei 0. Die im Dokument angegebenen Seitenzahlen und Formate werden ignoriert.

• "errorInformation": Enthält Fehlerinformationen, wenn das Dokument nicht geparst werden kann.

• "metadata": Enthält Metadaten zum Dokument, z. B. die Seitenanzahl.

Bemerkung

Die Felder "pages" und "metadata" sind in der Ausgabe vorhanden, wenn das Parsen erfolgreich war. "errorInformation" ist nur dann vorhanden, wenn das Parsen fehlgeschlagen ist.

Wenn 'page_split' FALSE oder nicht vorhanden ist, hat die Ausgabe die folgende Struktur:

• "content": Klartext (im OCR-Modus) oder Markdown-formatierter Text (im LAYOUT-Modus).

• "errorInformation": Enthält Fehlerinformationen, wenn das Dokument nicht geparst werden kann.

• "metadata": Enthält Metadaten zum Dokument, z. B. die Seitenanzahl.

Bemerkung

Die Felder "content" und "metadata" sind in der Ausgabe vorhanden, wenn das Parsen erfolgreich war. "errorInformation" ist nur dann vorhanden, wenn das Parsen fehlgeschlagen ist.

Beispiele¶

Weitere Beispiele finden Sie unter AI_PARSE_DOCUMENT-Beispiele.