Sonstige Funktionen

Verschiedene Funktionen enthalten die Syntax und Beschreibungen der Klassen, Methoden, Attribute und Parameter der Anwendungsprogrammierschnittstelle.

Verschiedene Funktionen enthalten die Syntax und Beschreibungen der Klassen, Methoden, Attribute und Parameter der Anwendungsprogrammierschnittstelle.

Tabellenliste - Vorgehensweise

Liste der Tabellen zurückgeben.

Syntax

Misc.list_tables(owner)

Parameter:

  • Eigentümer: In diesem Feld wird der Eigentümer des Objekts angezeigt. Wenn dieses Feld fehlt, verwendet das Tool den aktuellen Schemaeigentümer.

Beispiel

In diesem Beispiel können Sie eine Liste der Tabellen abrufen:
adp.Misc.list_tables()
 
// Output
 
{
  "nodes": [
    {
 "label": "COSTS",
      "type": "TABLE",
      "id": "\"ADMIN\".\"DB\".\"COSTS\"",
      "data": {
        "name": "COSTS",
        "namespace": "DB",
        "path": "\"DB\".\"COSTS\"",
        "schema": "ADMIN",
        "annotation": {
          "numRows": 82112,
          "status": "VALID",
          "blocks": 370,
          "avgRowLen": 26,
          "partitioned": "NO",
          "external": "NO",
          "sharded": "N",
          "tablespace": "DATA",
          "hasSensitiveColumn": "NO",
          "compression": "DISABLED"
        },
        "application": "DATABASE",
        "created": "2021-06-09T09:16:49Z",
        "updated": "2021-06-09T09:16:49Z",
        "catalog": "LOCAL"
      }
    },...
    ]
}
Prozedur "Liste der Ansichten"

Liste der Ansichten zurückgeben.

Syntax

Misc.list_views(owner)

Parameter:

  • Eigentümer: In diesem Feld wird der Eigentümer des Objekts angezeigt. Wenn dieses Feld fehlt, verwendet das Tool den aktuellen Schemaeigentümer.

Beispiel

In diesem Beispiel können Sie die Liste der Ansichten abrufen:

adp.Misc.list_views()
 
// Output
{
  "nodes": [
   {
      "label": "COSTS_AVVIEW",
      "type": "VIEW",
      "id": "\"ADMIN\".\"DB\".\"COSTS_AVVIEW\"",
      "data": {
        "name": "COSTS_AVVIEW",
        "namespace": "DB",
        "path": "\"DB\".\"COSTS_AVVIEW\"",
        "schema": "ADMIN",
        "application": "DATABASE",
        "created": "2024-11-21T10:00:16Z",
        "updated": "2024-11-21T10:00:16Z",
        "catalog": "LOCAL"
      },...
    ]
}
Tabellen löschen - Vorgehensweise

Löschen Sie die angegebene Tabelle.

Syntax

Misc.drop_table(table_name)

Parameter:

  • table_name: In diesem Feld wird der Name der zu löschenden Tabelle angezeigt.

Beispiel

In diesem Beispiel können Sie die Tabelle "TEST" löschen:

adp.Misc.drop_table('TEST')
Prozedur "Ansicht löschen"

Löschen Sie die angegebene Ansicht.

Syntax

Misc.drop_view(view_name)

Parameter:

  • view_name: In diesem Feld wird der Name der zu löschenden Ansicht angezeigt.

Beispiel

In diesem Beispiel können Sie die View "VIEW_TEST" löschen:
adp.Misc.drop_view('VIEW_TEST')
Tabellen löschen - Vorgehensweise

Angegebene Tabellen löschen

Syntax

Misc.drop_tables(table_names)

Parameter:

  • table_names: In diesem Feld wird das Array der Namen der zu löschenden Tabelle angezeigt.

Beispiel

In diesem Beispiel können Sie die Tabelle "TEST" löschen:

dp.Misc.drop_tables(['TEST'])
Prozedur "Views löschen"

Löschen Sie die angegebenen Ansichten.

Syntax

Misc.drop_views(view_names)

Parameter:

  • view_names: In diesem Feld wird das Array der Namen der zu löschenden Ansichten angezeigt.

Beispiel

In diesem Beispiel können Sie die Ansichten "VIEW_TEST" löschen:

DDL-Prozedur für Entität abrufen

DDL zum Erstellen oder Ersetzen von Entitys generieren (TABLE oder VIEW)

Syntax

Misc.get_entity_ddl(entity_type, entity_name,
                    owner)

Parameter:

  • entity_type: In diesem Feld wird der Typ der Entity angezeigt. Kann "TABLE" oder "VIEW" sein
  • entity_name: In diesem Feld wird der Name der Entity angezeigt.
  • Eigentümer: In diesem Feld wird der Eigentümer des Objekts angezeigt. Wenn dieses Feld fehlt, verwendet das Tool den aktuellen Schemaeigentümer.

Beispiel

In diesem Beispiel können Sie die DDL der Tabelle "TEST" anzeigen:

adp.Misc.get_entity_ddl('TABLE', 'TEST')
Abfrage ausführen

Ergebnisse der Abfrage zurückgeben

Syntax

Misc.run_query(statement, offset, limit, asof)

Parameter:

  • Anweisung: In diesem Feld wird die auszuführende SQL-Anweisung angezeigt
  • Offset: In diesem Feld wird der Offset zum angezeigten Datensatz angezeigt. Wenn dieses Feld fehlt, verwendet das Tool 0 als Offset.
  • Limit: In diesem Feld wird die maximale Anzahl der anzuzeigenden Datensätze angezeigt. Wenn dieses Feld fehlt, zeigt das Tool alle Datensätze an.
  • asof: AS OF-Anweisung zur Anzeige historischer Daten. Wenn dieses Feld fehlt, verwendet das Tool diese Funktion nicht.

Beispiel

In diesem Beispiel können Sie die Ansicht löschen:

adp.Misc.run_query('DROP VIEW "VIEW_TEST"')
Prozedur für globale Suche

Gibt das Ergebnis der Suche nach Datenbanken, Tabellen und anderen Artefakten aus Data Studio zurück.

Syntax

Misc.global_search(search_string, rowstart, numrow, sortBy,
                          hide_system_tables, hide_private_tables, resultapp,
                          resultannotation)

Parameter:

  • search_string: Zeichenfolge, die gesucht werden soll. Es sollte in der Form "( Besitzer: ADPTEST ) ( Typ: TABLE ) ( Anwendung: DATABASE )
  • rowstart: Erster Suchindex
  • numrow: Anzahl der zurückgegebenen Zeilen
  • sortBy: Liste der Sortierungen, z.B. [{column: "entity_name", direction: "asc"}]
  • hideSystemTables: Wenn dieses Feld fehlt, sollten auch Systemtabellen durchsucht werden.
  • hidePrivateTables: Wenn dieses Feld fehlt, sollten auch Systemtabellen durchsucht werden.
  • resultapp:
  • Ergebnisannotation:

Beispiel

In diesem Beispiel können Sie die Ansicht löschen:
adp.Misc.global_search('( owner: ADMIN ) ( type: TABLE ) ( application: DATABASE )', 1, 20001, [], TRUE, True, resultapp="ADPINS")
Tabellenspalten abrufen - Prozedur

Diese Funktion gibt die Liste der Spalteninformationen der Tabelle zurück

Syntax

Misc.get_table_columns(table_name, owner, limit,
                      offset)

Parameter:

  • table_name: In diesem Feld wird der Name der Tabelle angezeigt.
  • Eigentümer: In diesem Feld wird der Eigentümer des Objekts angezeigt. Wenn dieses Feld fehlt, verwendet das Tool den aktuellen Schemaeigentümer.
  • Grenzwert: Die maximale Anzahl an anzuzeigenden Spalten. Der Standardwert ist 256.
  • Versatz: Der Versatz der Spalten. Standardwert ist 0.

Beispiel

In diesem Beispiel können Sie Spalten der Tabelle "PERSONS" anzeigen:

adp.Misc.get_table_columns('PERSONS')
 
Output:
[
  {
    "column_name": "PERSON_ID",
    "data_type": "NUMBER",
    "nullable": "No",
    "data_default": "\"ADMIN\".\"ISEQ$$_329201\".nextval",
    "column_id": 1,
    "comments": null
  },
  {
    "column_name": "FIRST_NAME",
    "data_type": "VARCHAR2(50 BYTE)",
    "nullable": "No",
    "data_default": null,
    "column_id": 2,
    "comments": null
  },
  {
    "column_name": "LAST_NAME",
    "data_type": "VARCHAR2(50 BYTE)",
    "nullable": "No",
    "data_default": null,
    "column_id": 3,
    "comments": null
  }
]
Prozedur "Tabellen-Constraints abrufen"

Diese Funktion gibt die Liste der Constraints der Tabelle zurück.

Syntax

Misc.get_table_constraints(table_name, owner, limit,
                      offset)

Parameter:

  • table_name: In diesem Feld wird der Name der Tabelle angezeigt.
  • Eigentümer: In diesem Feld wird der Eigentümer des Objekts angezeigt. Wenn dieses Feld fehlt, verwendet das Tool den aktuellen Schemaeigentümer.
  • Grenzwert: Die maximale Anzahl an anzuzeigenden Spalten. Der Standardwert ist 256.
  • Offset: Der Offset der Spalten. Standardwert ist 0.

Beispiel

In diesem Beispiel können Sie Constraints der Tabelle "PERSONS" anzeigen:

adp.Misc.get_table_constraints('PERSONS')
 
Output:
 
[
  {
    "constraint_name": "SYS_C0056209",
    "constraint_type": "Check",
    "search_condition": "\"PERSON_ID\" IS NOT NULL",
...
  }
]
Zeile einfügen - Prozedur

Die Funktion fügt eine Zeile in die Tabelle ein

Syntax

Misc.insert_row(table_name, data, mapping, owner)

Parameter:

  • table_name: In diesem Feld wird der Name der Tabelle angezeigt.
  • data: Werte der Zeile, die als Formular {"data_column" : value,...} in die Tabelle eingefügt werden soll.
  • Zuordnung: Ordnen Sie Datenspaltennamen in Daten mit Spaltennamen der Tabelle zu. Wenn dieses Feld fehlt, verwendet das Tool Spaltennamen der Tabelle
  • Eigentümer: In diesem Feld wird der Eigentümer des Objekts angezeigt. Wenn dieses Feld fehlt, verwendet das Tool den aktuellen Schemaeigentümer.

Beispiel

In diesem Beispiel können Sie das Einfügen einer Zeile in die Tabelle "PERSONS" anzeigen, ohne Mapping und Mapping zu verwenden:

adp.Misc.insert_row('PERSONS', {"PERSON_ID":1, "FIRST_NAME":"John", "LAST_NAME":"Smith"})
adp.Misc.insert_row('PERSONS', {"ID":1, "FIRST":"John", "LAST":"Smith"}, {"ID":"PERSON_ID", "FIRST":"FIRST_NAME", "LAST":"LAST_NAME"})

Zeilen aktualisieren - Vorgehensweise

Die Funktion aktualisiert die vorhandene Zeile in der Tabelle.

Syntax

Misc.update_row(table_name, data,  where_col, mapping,
                        owner)

Parameter:

  • table_name: In diesem Feld wird der Name der Tabelle angezeigt.
  • data: Werte der Zeile, die als Formular {"data_column" : value,...} in die Tabelle eingefügt werden soll.
  • where_col: Der Name des Spalten-Huts wird in der Where-Klausel verwendet. Der Wert dieser Spalte muss in Daten enthalten sein
  • Zuordnung: Ordnen Sie Datenspaltennamen in Daten mit Spaltennamen der Tabelle zu. Wenn dieses Feld fehlt, verwendet das Tool Spaltennamen der Tabelle
  • Eigentümer: In diesem Feld wird der Eigentümer des Objekts angezeigt. Wenn dieses Feld fehlt, verwendet das Tool den aktuellen Schemaeigentümer.

Beispiel

In diesem Beispiel können Sie das Einfügen einer Zeile in die Tabelle "PERSONS" anzeigen, ohne Mapping und Mapping zu verwenden:

adp.Misc.update_row('PERSONS', {"PERSON_ID":1, "FIRST_NAME":"Adam"},  'PERSON_ID')
adp.Misc.update_row('PERSONS', {"ID":1, "FIRST":"Adam"}, 'ID', {"ID":"PERSON_ID", "FIRST":"FIRST_NAME"})

Übergeordnetes Thema: Mit Python Data Studio-API für Autonomous Database arbeiten