Tutorial 1: Datenbanken, Schemas und Tabellen erstellen und verwalten¶

Einführung¶

In diesem Tutorial lernen Sie, wie Sie REST-Abfragen stellen, um Datenbanken, Tabellen und Schemas zu erstellen und zu verwalten.

Eine Datenbank erstellen und die verfügbaren Datenbanken auflisten¶

Sie können Postman verwenden, um eine Datenbank zu erstellen und die verfügbaren Datenbanken aufzulisten.

• Um eine Datenbank zu erstellen, senden Sie eine POST-Anfrage mit dem folgenden Body an den /api/v2/databases Endpunkt, wie gezeigt.

  {
    "name": "demo_db",
    "kind": "PERMANENT",
    "comment": "snowflake rest api demo-db",
    "data_retention_time_in_days": "1",
    "max_data_extension_time_in_days": "1"
  }
  

  Copy

  

• Um die verfügbaren Datenbanken aufzulisten, senden Sie eine GET-Anfrage an den Endpunkt /api/v2/databases, wie in den folgenden Beispielen gezeigt:

  • Um Datenbanken zu finden, deren Name die Zeichenfolge demo enthält, geben Sie %25demo%25 im Parameter like für die Abfrage ein.

    

  • Um die erste Datenbank zurückzugeben, deren Name mit der Zeichenfolge DEMO_DB beginnt, geben Sie DEMO_DB und 1 in den Abfrageparametern startsWith bzw. showLimit an.

    

Weitere Informationen finden Sie in der Snowflake Datenbank-API-Referenz.

Erstellen eines Schemas und Auflistung der verfügbaren Schemas¶

Sie können Postman verwenden, um ein Schema zu erstellen und die verfügbaren Schemas aufzulisten.

• Um ein Schema zu erstellen, senden Sie eine POST-Anfrage an den Endpunkt /api/v2/databases/{database}/schemas, wie folgt:

  1. Fügen Sie den Namen der Datenbank (demo_db) zur database-Pfadvariable im Header der Anfrage hinzu.

     

  2. Fügen Sie den Namen des Schemas (demo_sc) in den Body der Anfrage ein.

     {
       "name": "demo_sc",
     }
     

     Copy

     

• Um verfügbare Schemas aufzulisten, senden Sie eine GET-Anfrage an den Endpunkt /api/v2/databases/{database}/schemas. In diesem Beispiel geben Sie das erste Schema zurück, dessen Name mit der DEMO_SC-Zeichenfolge beginnt, indem Sie DEMO_SC und 1 in den Abfrageparametern startsWith bzw. showLimit angeben.

  

Weitere Informationen finden Sie in der Snowflake Schema API-Referenz.

Erstellen Sie eine Tabelle und rufen Sie die Tabellendetails ab¶

Sie können Postman verwenden, um eine Tabelle zu erstellen und die verfügbaren Tabellen aufzulisten.

• Um eine Tabelle zu erstellen, senden Sie eine Anfrage POST an den Endpunkt /api/v2/databases/{database}/schemas/{schema}/tables, wie folgt:

  1. Fügen Sie den Namen der Datenbank (demo_db) und den Namen des Schemas (demo_sc) in den Pfadvariablen database bzw. database im Header der Anfrage hinzu.

     

  2. Fügen Sie den Tabellennamen (demo_tbl) und die Tabellenspalten zum Body der Anfrage hinzu. In diesem Fall haben Sie eine Spalte mit dem C1-Namen hinzugefügt.

     {
       "name": "demo_tbl",
       "columns": [
         {
         "name": "c1",
         "datatype": "integer",
         "nullable": true,
         "comment": "An integral value column"
         }
       ],
       "comment": "Demo table for Snowflake REST API"
     }
     

     Copy

     

• Um die soeben erstellte Tabelle abzurufen, senden Sie eine GET-Anfrage an den Endpunkt /api/v2/databases/{database}/schemas/{schema}/tables/{name}. In diesem Fall geben Sie demo_db, demo_sc und demo_tbl jeweils in den Pfadvariablen database, schema und name an.

  

Weitere Informationen finden Sie in der Snowflake-Tabelle API-Referenz.

Eine Tabelle ändern und die Tabellendetails abrufen¶

Sie können Postman verwenden, um eine Tabelle zu ändern.

• Um die Tabelle zu ändern, die Sie im letzten Tutorial erstellt haben, senden Sie eine Anfrage :codenowrap:`PUT an den Endpunkt :api/v2/databases/{database}/schemas/{schema}/tables/{name}`, wie folgt:

  1. Geben Sie die Namen der Datenbank, des Schemas und der Tabelle, die Sie erstellt haben, in den entsprechenden Pfad-Variablen an.

     

  2. Geben Sie im Body der Anfrage die Definition der neuen Tabelle ein. In diesem Fall fügen Sie der Tabelle eine neue Spalte hinzu.

     {
       "name": "demo_tbl",
       "columns": [
         {
         "name": "c1",
         "datatype": "integer",
         "nullable": true,
         "comment": "An integral value column"
         },
         {
         "name": "c2",
         "datatype": "string",
         "comment": "An string value column"
         }
       ],
       "comment": "Demo table for Snowflake REST API"
     }
     

     Copy

     

• Überprüfen Sie die Änderung, indem Sie die Tabellendetails abrufen, indem Sie eine Anfrage GET an den Endpunkt /api/v2/databases/{database}/schemas/{schema}/tables/{name} senden. In diesem Fall geben Sie demo_db, demo_sc und demo_tbl jeweils in den Pfadvariablen database, schema und name an.

  

  Beachten Sie, dass die Tabelle jetzt eine neue C2-Spalte enthält.

Weitere Informationen finden Sie in der Snowflake-Tabelle API-Referenz.

Auflistung der verfügbaren Tabellen¶

Sie können den Endpunkt /api/v2/databases/{database}/schemas/{schema}/tables verwenden, um Auflistungen aller Ihnen zur Verfügung stehenden Tabellen zu erhalten.

• Um alle verfügbaren Tabellen aufzulisten, senden Sie eine Anfrage GET an den Endpunkt /api/v2/databases/{database}/schemas/{schema}/tables ohne Abfrage-Parameter, wie folgt. In diesem Fall geben Sie demo_db und demo_sc bzw. demo_tbl in den Pfadvariablen database, schema und name an.

  

• Um eine vollständige Auflistung der Spalten und Einschränkungen in jeder Tabelle zu erhalten, fügen Sie den recursive-Parameter für die Abfrage hinzu und setzen den Wert auf true, wie gezeigt. Beachten Sie, dass die Aktivierung dieses Parameters für die Abfrage Ihre Verbindung überfordern kann, wenn Sie mehrere komplexe Tabellen haben.

  

Weitere Informationen finden Sie in der Snowflake-Tabelle API-Referenz.

Nächste Schritte¶

Herzlichen Glückwunsch! In diesem Tutorial haben Sie die Grundlagen für die Verwaltung von Snowflake-Datenbank-, Schema- und Tabellenressourcen unter Verwendung von Snowflake REST APIs gelernt.