CREATE DATABASE - Amazon Athena
SyntaxParameterBeispieleAnzeigen von Datenbankeigenschaften

CREATE DATABASE

Erstellt eine Datenbank. Sie können DATABASE oder SCHEMA gleichwertig verwenden. Sie haben dieselbe Bedeutung.

Anmerkung

Für ein Beispiel für das Erstellen einer Datenbank, das Erstellen einer Tabelle und das Ausführen einer SELECT-Abfrage auf dem Tisch in Athena siehe Erste Schritte.

Syntax

CREATE {DATABASE|SCHEMA} [IF NOT EXISTS] database_name
  [COMMENT 'database_comment']
  [LOCATION 'S3_loc']
  [WITH DBPROPERTIES ('property_name' = 'property_value') [, ...]]

Einschränkungen für Datenbanknamen in Athena finden Sie unter Namen für Datenbanken, Tabellen und Spalten.

Parameter

[IF NOT EXISTS]

Führt dazu, dass der Fehler unterdrückt wird, wenn eine Datenbank mit dem Namen database_name bereits vorhanden ist.

[COMMENT database_comment]

Legt den Metadatenwert für die integrierte Metadateneigenschaft namens comment und den Wert, den Sie für database_comment angeben, fest. In AWS Glue wird der COMMENT-Inhalt in das Description-Feld der Datenbankeigenschaften geschrieben.

[LOCATION S3_loc]

Legt den Speicherort fest, an dem Datenbankdateien und Metaspeicher als abgelegt werden S3_loc. Der Speicherort muss ein Amazon S3-Speicherort sein.

[WITH DBPROPERTIES ('property_name' = 'property_value') [, ...] ]

Ermöglicht Ihnen, benutzerdefinierte Metadateneigenschaften für die Datenbankdefinition festzulegen.

Beispiele

CREATE DATABASE clickstreams;
CREATE DATABASE IF NOT EXISTS clickstreams
  COMMENT 'Site Foo clickstream data aggregates'
  LOCATION 's3://amzn-s3-demo-bucket/clickstreams/'
  WITH DBPROPERTIES ('creator'='Jane D.', 'Dept.'='Marketing analytics');

Anzeigen von Datenbankeigenschaften

Um die Datenbankeigenschaften für eine Datenbank anzuzeigen, die Sie in AWSDataCatalog mit CREATE DATABASE erstellen, können Sie den AWS CLI-Befehl aws glue get-database wie im folgenden Beispiel verwenden:

aws glue get-database --name <your-database-name>

In der JSON-Ausgabe sieht das Ergebnis wie folgt aus:

{
    "Database": {
        "Name": "<your-database-name>",
        "Description": "<your-database-comment>",
        "LocationUri": "s3://amzn-s3-demo-bucket",
        "Parameters": {
            "<your-database-property-name>": "<your-database-property-value>"
        },
        "CreateTime": 1603383451.0,
        "CreateTableDefaultPermissions": [
            {
                "Principal": {
                    "DataLakePrincipalIdentifier": "IAM_ALLOWED_PRINCIPALS"
                },
                "Permissions": [
                    "ALL"
                ]
            }
        ]
    }
}

Weitere Informationen zur AWS CLI finden Sie im AWS Command Line Interface-Benutzerhandbuch.