LISTCOSOBJECTS gespeicherte Prozedur

Letzte Aktualisierung: 17. März 2025

LISTCOSOBJECTS gespeicherte Prozedur in der Data Virtualization

Gibt eine Liste von Objekten aus einem Cloud Object Storage (COS) zurück.

Eingabeparameter

URL: Der Typ dieses erforderlichen Parameters ist VARCHAR (2000). Gibt die URL der Cloud Object Storage an.

OPTIONSCSV

Der Typ dieses optionalen Parameters ist VARCHAR (32672). Gibt eine durch Komma getrennte Liste von Zeichenfolgen für zusätzliche Optionen an:

MAXOBJS=<N>, wobei <N> die maximale Anzahl der Objekte ist, die von URL abgerufen werden sollen. Der Standardwert ist -1. Um alle Objekte zu erhalten, verwenden Sie -1 oder eine beliebige negative Zahl.
LIMLVLS '= '<true or false>, bestimmt, ob nur eine Ebene von Kindern aus einem Verzeichnis abgerufen werden soll. Der Standardwert ist 'false'.

Ausgabeparameter

DIAGS: Der Typ dieses Parameters ist VARCHAR (32672). Stellt die Diagnoseausgabe dar, wenn ein Fehler auftritt.

Syntax

Verwenden Sie die folgende Syntax und ersetzen Sie die Parameter für diese gespeicherte Prozedur:

CALL DVSYS.LISTCOSOBJECTS('<URL>', '<OPTIONSCSV>', ?)

Beispiel

call DVSYS.LISTCOSOBJECTS('s3a://bigsql-local/', 'MAXOBJS=10,LIMLVLS=true', ?)

Die Ausgabe könnte wie der folgende Text aussehen:


+-------------------------------------------------------------------------+-----------+--------+-------------------------+---------+
| URL                                                                     | TYPE      | LENGTH | MODIFIED                | DETAILS |
+-------------------------------------------------------------------------+-----------+--------+-------------------------+---------+
| s3a://bigsql-local/test.csv                                             | text/csv  |      6 | 2021-05-27 10:52:43.223 |         |
| s3a://bigsql-local/i_1622137540270_2041104231_20210527104639828_1.0.csv | text/csv  |      6 | 2021-05-27 10:51:03.506 |         |
| s3a://bigsql-local/files_1000000                                        | directory |      0 | 2021-06-04 12:34:53.915 |         |
| s3a://bigsql-local/files_100000                                         | directory |      0 | 2021-06-04 12:34:53.915 |         |
| s3a://bigsql-local/files_10000                                          | directory |      0 | 2021-06-04 12:34:53.914 |         |
| s3a://bigsql-local/files_1000                                           | directory |      0 | 2021-06-04 12:34:53.914 |         |
| s3a://bigsql-local/Table7                                               | directory |      0 | 2021-06-04 12:34:53.913 |         |
| s3a://bigsql-local/Table3                                               | directory |      0 | 2021-06-04 12:34:53.913 |         |
| s3a://bigsql-local/Table27                                              | directory |      0 | 2021-06-04 12:34:53.913 |         |
| s3a://bigsql-local/Table1                                               | directory |      0 | 2021-06-04 12:34:53.912 |         |
+-------------------------------------------------------------------------+-----------+--------+-------------------------+---------+

10 rows in results(first row: 0.052s; total: 0.066s)

+-------------+----------+
| Return Code | Param #2 |
+-------------+----------+
| -1992425446 | [NULL]   |
+-------------+----------+