TRY_TO_FILE

Eine Version von TO_FILE, die NULL zurückgibt, anstatt einen Fehler zu melden.

Syntax

Verwenden Sie eine der folgenden Optionen:

TRY_TO_FILE( <stage_name>, <relative_path> )

TRY_TO_FILE( <file_url> )

TRY_TO_FILE( <metadata> )

Argumente

Geben Sie die Datei an, indem Sie Folgendes angeben:

  • Sowohl stage_name als auch relative_path

  • file_url

  • metadata

Es kann jeweils nur eine dieser Methoden verwendet werden.

stage_name

Der Name des Stagingbereichs, in dem sich die Datei befindet, als Zeichenfolge im Format '@stage_name'.

relative_path

Der Pfad zu der Datei im durch stage_name als Zeichenfolge angegebenen Stagingbereich.

file_url

Ein gültiger Stagingbereich oder eine Bereichsdatei-URL als Zeichenfolge.

metadata

Ein OBJECT, das die erforderlichen FILE-Attribute enthält. Eine FILE muss Felder des Typs CONTENT_TYPE, SIZE, ETAG und LAST_MODIFIED haben. Außerdem muss der Speicherort der Datei auf eine der folgenden Arten angegeben werden:

  • Sowohl STAGE als auch RELATIVE_PATH

  • STAGE_FILE_URL

  • SCOPED_FILE_URL

Rückgabewerte

Eine FILE oder NULL.

Nutzungshinweise

Gibt NULL zurück, wenn:

  • Die angegebene URL nicht gültig ist.

  • Die Datei befindet sich in einem Stagingbereich, für den der Benutzende keine Zugriffsrechte hat.

  • Die angegebenen Metadaten enthalten nicht die erforderlichen FILE-Felder.

Beispiele

Im Gegensatz zu TO_FILE, das bei ungültigen Argumenten einen Fehler auslöst, gibt TRY_TO_FILE in dieser Situation NULL zurück. Ansonsten funktioniert es genau wie TO_FILE.

Das folgende Beispiel veranschaulicht das Verhalten von TRY_TO_FILE bei Angabe eines ungültigen Dateipfads, vorausgesetzt, dass die Datei image.png im Stagingbereich existiert, die beiden anderen Dateien jedoch nicht.

SELECT
    TRY_TO_FILE('@mystage/image.png'),
    TRY_TO_FILE('@mystage/incorrect_file1.jpg'),
    TRY_TO_FILE('@mystage', 'incorrect_file2.png');
Copy

Ergebnis:

+-----------------------------------------------------+---------------------------------------------+------------------------------------------------+
| TRY_TO_FILE('@MYSTAGE/IMAGE.PNG')                   | TRY_TO_FILE('@MYSTAGE/INCORRECT_FILE1.JPG') | TRY_TO_FILE('@MYSTAGE', 'INCORRECT_FILE2.PNG') |
|-----------------------------------------------------|---------------------------------------------|------------------------------------------------|
| {                                                   | NULL                                        | NULL                                           |
|   "CONTENT_TYPE": "image/png",                      |                                             |                                                |
|   "ETAG": "2859efde6e26491810f619668280a2ce",       |                                             |                                                |
|   "LAST_MODIFIED": "Thu, 18 Sep 2025 09:02:00 GMT", |                                             |                                                |
|   "RELATIVE_PATH": "image.png",                     |                                             |                                                |
|   "SIZE": 23698,                                    |                                             |                                                |
|   "STAGE": "@MYDB.MYSCHEMA.MYSTAGE"                 |                                             |                                                |
| }                                                   |                                             |                                                |
+-----------------------------------------------------+---------------------------------------------+------------------------------------------------+

Weitere Beispiele für die Erstellung von FILE-Objekten aus gültigen Eingaben finden Sie unter TO_FILE-Beispiele.

Sprache: Deutsch