Unterstützte Formate für Amazon-S3-Manifestdateien

Sie verwenden JSON-Manifestdateien, um Dateien in Amazon S3 anzugeben, die in Amazon importiert werden sollen QuickSight. Diese JSON-Manifestdateien können entweder das folgende Amazon- QuickSight Format oder das Amazon-Redshift-Format verwenden, das unter Verwenden eines Manifests zur Angabe von Datendateien im Datenbankentwicklerhandbuch zu Amazon Redshift beschrieben wird. Sie müssen Amazon Redshift nicht verwenden, um das Amazon-Redshift-Manifest-Dateiformat zu verwenden.

Wenn Sie eine Amazon- QuickSight Manifestdatei verwenden, muss diese über eine JSON-Erweiterung verfügen, z. B. my_manifest.json. Eine Amazon-Redshift-Manifestdatei kann jede beliebige Erweiterung haben.

Wenn Sie eine Amazon-Redshift-Manifestdatei verwenden, QuickSight verarbeitet Amazon die optionale mandatory Option wie Amazon Redshift. Wenn die zugehörige Datei nicht gefunden wird, QuickSight beendet Amazon den Importvorgang und gibt einen Fehler zurück.

Dateien, die Sie für den Import auswählen, müssen getrennten Text enthalten (z. B. .csv oder .tsv), Log- (.clf) oder erweitertes Log-Format (.elf) aufweisen oder JSON (.json) sein. Alle Dateien, die in einer Manifestdatei identifiziert werden, müssen dasselbe Dateiformat haben. Darüber hinaus müssen sie dieselbe Anzahl und denselben Typ an Spalten haben. Amazon QuickSight unterstützt UTF-8-Dateikodierung, aber nicht UTF-8 (mit ap-south-1). Wenn Sie JSON-Dateien importieren, müssen Sie für globalUploadSettings format angeben, aber nicht delimiter, textqualifier oder containsHeader.

Stellen Sie sicher, dass sich alle von Ihnen angegebenen Dateien in Amazon S3-Buckets befinden, für die Sie Amazon QuickSight Zugriff gewährt haben. Informationen zum AWS Gewähren von Amazon- QuickSight Zugriff auf -Ressourcen finden Sie unter Zugreifen auf Datenquellen.

Manifestdateiformat für Amazon QuickSight

Amazon QuickSight -Manifestdateien verwenden das folgende JSON-Format.

{
    "fileLocations": [
        {
            "URIs": [
                "uri1",
                "uri2",
                "uri3"
            ]
        },
        {
            "URIPrefixes": [
                "prefix1",
                "prefix2",
                "prefix3"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON",
        "delimiter": ",",
        "textqualifier": "'",
        "containsHeader": "true"
    }
}
                            

Verwenden Sie die Felder im fileLocations-Element zur Festlegung der zu importierenden Dateien. Nutzen Sie die Felder im globalUploadSettings-Element zur Angabe von Importeinstellungen für diese Dateien, beispielsweise Feldtrennzeichen.

Die Elemente der Manifestdatei werden im Folgenden beschrieben:

• fileLocations – Geben Sie über dieses Element die zu importierenden Dateien an. Sie können einen oder beide der Arrays URIs und URIPrefixes verwenden. Sie müssen mindestens einen Wert einem der Arrays angeben.

  • URIs – Nutzen Sie diesen Array zum Auflisten von URIs für bestimmte zu importierende Dateien.

    Amazon QuickSight kann auf Amazon S3-Dateien zugreifen, die sich in jeder befinden AWS-Region. Sie müssen jedoch ein URI-Format verwenden, das die AWS Region des Amazon S3-Buckets identifiziert, wenn es sich von dem unterscheidet, das von Ihrem Amazon- QuickSight Konto verwendet wird.

    Folgende URI-Formate werden unterstützt.

    URI-Format	Beispiel	Kommentare
    https://s3.amazonaws.com/<Bucket-Name>/<Dateiname>	https://s3.amazonaws.com/awsexamplebucket/data.csv
    s3://<Bucket-Name>/<Dateiname>	s3://awsexamplebucket/data.csv
    https://<Bucket-Name>.s3.amazonaws.com/<Dateiname>	https://awsexamplebucket.s3.amazonaws.com/data.csv
    https://s3-<Regionsname>.amazonaws.com/<Bucket-Name>/<Dateiname>	https://s3-us-east-1.amazonaws.com/awsexamplebucket/data.csv	Über diesen URI-Typ wird die AWS-Region für den Amazon-S3-Bucket identifiziert.
    https://<Bucket-Name>.s3-<Regionsname>.amazonaws.com/<Dateiname>	https://awsexamplebucket.s3-us-east-1.amazonaws.com/data.csv	Dieser URI-Typ identifiziert die AWS-Region für den Amazon S3-Bucket.

  • URIPrefixes – Listen Sie über diesen Array URI-Präfixe für S3-Buckets und -Ordner auf. Alle Dateien in einem bestimmten Bucket oder Ordner werden importiert. Amazon ruft QuickSight rekursiv Dateien aus untergeordneten Ordnern ab.

    QuickSight kann auf Amazon S3-Buckets oder -Ordner zugreifen, die sich in jeder befinden AWS-Region. Stellen Sie sicher, dass Sie ein URI-Präfixformat verwenden, das die des S3-Buckets identifiziert, AWS-Region wenn es sich von dem von Ihrem QuickSight Konto verwendeten unterscheidet.

    Folgende URI-Präfix-Formate werden unterstützt.

    URI-Präfixformat	Beispiel	Kommentare
    https://s3.amazonaws.com/<Bucket-Name>/	https://s3.amazonaws.com/awsexamplebucket/
    https://s3.amazonaws.com/<Bucket-Name>/<Ordnername1>/(<Ordnername2>/etc.)	https://s3.amazonaws.com/awsexamplebucket/folder1/
    s3://<Bucket-Name>	s3://awsexamplebucket/
    s3://<Bucket-Name>/<Ordnername1>/(<Ordnername2>/etc.)	s3://awsexamplebucket/folder1/
    https://<Bucket-Name>.s3.amazonaws.com	https://awsexamplebucket.s3.amazonaws.com
    https://s3-<Regionsname>.amazonaws.com/<Bucket-Name>/	https://s3--your-region-for-example-us-east-2.amazonaws.com/awsexamplebucket /	Dieser URIPrefix Typ identifiziert die AWS-Region für den Amazon S3-Bucket.
    https://s3-<Regionsname>.amazonaws.com/<Bucket-Name>/<Ordnername1>/(<Ordnername2>/etc.)	https://s3-us-east-1.amazonaws.com/awsexamplebucket/folder1/	Dieser URIPrefix Typ identifiziert die AWS-Region für den Amazon S3-Bucket.
    https://<Bucket-Name>.s3-<Regionsname>.amazonaws.com	https://awsexamplebucket.s3-us-east-1.amazonaws.com	Dieser URIPrefix Typ identifiziert die AWS-Region für den Amazon S3-Bucket.

• globalUploadSettings – (Optional) Verwenden Sie dieses Element, um Importeinstellungen für die Amazon S3-Dateien anzugeben, z. B. Feldtrennzeichen. Wenn dieses Element nicht angegeben ist, QuickSight verwendet Amazon die Standardwerte für die Felder in diesem Abschnitt.

  Wichtig

  Für Protokoll (.clf)- und erweiterte Protokolldateien (.elf) ist nur das Feld format in diesem Abschnitt relevant. Sie können die anderen Felder überspringen. Wenn Sie diese miteinschließen, werden die Feldwerte ignoriert.

  • format – (Optional) Geben Sie das Format der zu importierenden Dateien an. Gültige Formate sind CSV, TSV, CLF, ELF und JSON. Der Standardwert ist CSV.

  • delimiter – (Optional) Geben Sie das Feldtrennzeichen der Datei an. Dieses muss mit dem Dateityp übereinstimmen, der im Feld format angegeben ist. Gültige Trennzeichen sind Kommas (,) bei CSV-Dateien und Tabulatoren (\t) bei TSV-Dateien. Der Standardwert ist ein Komma (,).

  • textqualifier – (Optional) Geben Sie den Textqualifizierer der Datei an. Gültige Formate sind einfache Anführungszeichen (') sowie doppelte Anführungszeichen (\"). Der führende Backslash ist ein erforderliches Escape-Zeichen für doppelte Anführungszeichen in JSON. Standardmäßig werden doppelte Anführungszeichen (\") verwendet. Wenn Ihr Text keinen Textqualifizierer benötigt, fügen Sie diese Eigenschaft nicht hinzu.

  • containsHeader – (Optional) Geben Sie an, ob die Datei eine Kopfzeile enthält. Gültige Formate sind true oder false. Der Standardwert ist true.

Beispiele für Manifestdateien für Amazon QuickSight

Im Folgenden finden Sie einige Beispiele für abgeschlossene Amazon- QuickSight Manifestdateien.

Das folgende Beispiel zeigt eine Manifestdatei, die zwei spezifische CSV-Dateien für den Import identifiziert. Diese Dateien verwenden doppelte Anführungszeichen als Textqualifizierer. Die Felder format, delimiter und containsHeader werden übersprungen, da die Standardwerte akzeptiert werden.

{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.csv",
                "https://yourBucket.s3.amazonaws.com/data-file-2.csv"
            ]
        }
    ],
    "globalUploadSettings": {
        "textqualifier": "\""
    }
}

Das folgende Beispiel zeigt eine Manifestdatei, die eine spezifische TSV-Datei für den Import identifiziert. Diese Datei enthält auch einen Bucket in einer anderen AWS -Region, der zusätzliche TSV-Dateien für den Import enthält. Die Felder textqualifier und containsHeader werden übersprungen, da Standardwerte akzeptiert werden.

{
    "fileLocations": [
        {
            "URIs": [
                "https://s3.amazonaws.com/awsexamplebucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/awsexamplebucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}

Das folgende Beispiel zeigt zwei Buckets mit .clf-Dateien für den Import enthalten. Eine befindet sich in derselben AWS-Region wie das Amazon- QuickSight Konto und eine in einer anderen AWS-Region. Die Felder delimiter, textqualifier und containsHeader werden übersprungen, da sie nicht für Protokolldateien gelten.

{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://awsexamplebucket.your-s3-url.com",
                "s3://awsexamplebucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}

Im folgenden Beispiel wird das Amazon-Redshift-Format zum Identifizieren einer CSV-Datei für den Import verwendet.

{
    "entries": [
        {
            "url": "https://awsexamplebucket.your-s3-url.com/myalias-test/file-to-import.csv",
            "mandatory": true
        }
    ]
}

Im folgenden Beispiel wird das Amazon-Redshift-Format zum Identifizieren von zwei JSON-Dateien für den Import verwendet.

{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.json",
                "https://yourBucket.s3.amazonaws.com/data-file-2.json"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON"
    }
}