Die Amazon S3-Quelle liest Datensätze aus Dateien in einem Amazon S3-Bucket und führt die Analyse in ArcGIS Velocity durch.
Beispiele
Im Folgenden finden Sie Beispiele für die Verwendung der Amazon S3-Quelle:
- Ein Forscher möchte Hunderte von durch Trennzeichen getrennten Textdateien aus einem Amazon S3-Bucket in Velocity laden, um eine Analyse durchzuführen.
- Eine GIS-Abteilung speichert häufig verwendete Grenzen-Shapefiles in einem Amazon S3-Bucket und möchte das Landkreisgrenzen-Shapefile als Aggregationsgrenze in Velocity laden.
Verwendungshinweise
Beachten Sie beim Arbeiten mit der Amazon S3-Quelle Folgendes:
- Alle Dateien im Amazon S3 -Bucket, die durch das Benennungsmuster im Dataset-Parameter identifiziert werden, müssen denselben Schema- und Geometrietyp aufweisen. Wenn Sie einen Ordnernamen für den Dataset-Parameter angeben, müssen alle Dateien in den Verzeichnissen denselben Dateityp und dasselbe Schema aufweisen.
- Ein geheimer Zugriffsschlüssel wird beim erstmaligen Speichern der Analyse verschlüsselt und in verschlüsseltem Zustand gespeichert.
- Verwenden Sie bei der Angabe des Ordnerpfades Schrägstriche (/).
- Nachdem Sie die Quellverbindungseigenschaften konfiguriert haben, lesen Sie Konfigurieren von Eingabedaten, um zu erfahren, wie Sie das Schema und die Schlüsseleigenschaften definieren.
- Wenn Sie den Zugriffsmodus Öffentlich verwenden, um mithilfe von Velocity eine Verbindung zu öffentlichen Amazon S3-Buckets herzustellen, muss bei dem öffentlichen Amazon S3-Bucket in der Bucket-Zugriffssteuerungsliste die Aktion Liste auf Alle (öffentlicher Zugriff) gesetzt sein.
- Es sind bestimmte Amazon S3-Aktionen für die Benutzerrichtlinie, die mit dem angegebenen Amazon-Schlüssel verknüpft ist, erforderlich, damit Velocity erfolgreich eine Verbindung zu einem Amazon S3-Bucket und den Daten in dem bereitgestellten angegebenen Bucket und dem Ordnerpfad herstellen kann.
- Für den angegebenen Bucket wird die Aktion s3:ListBucket benötigt.
- Für den angegebenen Ordnerpfad und die Unterressourcen (arn:aws:s3:::yourBucketName/*) für eine Amazon S3-Quelle zum Lesen von Daten ist die Aktion s3:GetObject erforderlich.
Parameter
| Parameter | Beschreibung | Datentyp |
|---|---|---|
Zugriffsschlüssel | Die Amazon-Zugriffsschlüssel-ID für den S3-Bucket, z. B. AKIAIOSFODNN7EXAMPLE. Velocity verwendet den Zugriffsschlüssel, um angegebene Datenquellen in die App zu laden. Informationen zu Amazon-Zugriffsschlüsseln finden Sie unter Zugreifen auf AWS mit Ihren AWS-Anmeldeinformationen in der AWS-Documentation. | Zeichenfolge |
Geheimer Schlüssel | Der geheime Amazon-Zugriffsschlüssel für den S3-Bucket, z. B.: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY. Velocity verwendet den Zugriffsschlüssel, um angegebene Datenquellen in die App zu laden. Ein geheimer Zugriffsschlüssel wird beim erstmaligen Speichern der Analyse verschlüsselt und in verschlüsseltem Zustand gespeichert. Informationen zu geheimen Amazon-Zugriffsschlüsseln finden Sie unter Zugreifen auf AWS mit Ihren AWS-Anmeldeinformationen in der AWS-Dokumentation. | Zeichenfolge |
S3-Bucket-Name | Der Name des Amazon S3-Buckets, der die zu lesenden Dateien enthält. | Zeichenfolge |
Ordnerpfad | Der Pfad des Ordners, der die Dateien enthält, die in Velocity geladen werden sollen.
| Zeichenfolge |
Dataset | Der Name der zu lesenden Datei, wenn Sie eine einzelne Datei laden, oder ein Muster, das eine Gruppe von Dateien angibt, gefolgt von der Dateinamenserweiterung. Zum Erstellen eines Musters, das eine Gruppe von Dateien angibt, verwenden Sie ein Sternchen (*) als Platzhalter, entweder einzeln oder zusammen mit einem partiellen Dateinamen. Alle durch das Benennungsmuster identifizierten Dateien müssen denselben Schema- und Geometrietyp aufweisen. Wenn Sie mehrere Dateien oder verschachtelte Ordner laden, können Sie anstelle eines Dateinamens mit Erweiterung auch den Namen des Ordners angeben, der den Dataset enthält. Wenn Sie als Dataset den Namen eines Ordners angeben, können Sie keine Platzhalter verwenden oder Dateitypen einschränken. Alle Dateien aus dem angegebenen Ordner werden erfasst und sollten alle denselben Dateityp haben. Nachfolgend finden Sie einige Beispiele:
| Zeichenfolge |
Nur zuletzt verwendete Dateien laden | Gibt an, ob die Amazon S3-Quelle alle Dateien lädt oder nur die Dateien, die seit der letzten Ausführung der Analyse erstellt oder modifiziert wurden.
Dieser Parameter kann nur für geplante Big-Data-Analysen auf true festgelegt werden. Wenn bei der ersten Ausführung einer geplanten Big-Data-Analyse dieser Parameter auf true festgelegt ist, werden die Big-Data-Analysen ausgeführt, ohne dass Dateien geladen werden. Bei nachfolgenden Ausführungen der Analyse werden Dateien geladen, die seit der letzten geplanten Ausführung dieser Analyse zuletzt geändert wurden. | Boolesch |
Überlegungen und Beschränkungen
Es gibt verschiedene Überlegungen, die bei der Verwendung derAmazon S3-Quelle in Betracht gezogen werden sollten:
- Alle Dateien im Amazon S3-Bucket, die durch das Benennungsmuster in der Dataset-Eigenschaft identifiziert werden, müssen denselben Schema- und Geometrietyp aufweisen.
- Das Erfassen von JSON-Daten mit einem Array von Objekten, auf das von einem Stammknoten verwiesen wird, wird für Amazon S3- oder Azure Blob-Speicher derzeit nicht unterstützt.