?> addRegion - WeAreCAS
s3

addRegion

Beschreibung

Fügt benutzerdefinierte Regionen für die S3-Umgebung hinzu oder ersetzt sie. Diese Aktion ist entscheidend für die Konfiguration von CAS (Cloud Analytic Services), um mit S3-Speicherorten zu interagieren, die sich nicht in den standardmäßig von AWS vordefinierten Regionen befinden. Sie ermöglicht es Administratoren, die Konnektivität zu privaten oder benutzerdefinierten S3-kompatiblen Speichern zu definieren, indem sie den Host, den Port und die SSL-Einstellungen angeben.

s3.addRegion <result=Ergebnis> <status=rc> / host="Zeichenfolge", name="Zeichenfolge", <nossl=TRUE | FALSE>, <port=64-Bit-Ganzzahl>, <region="Zeichenfolge">, <sslallowed=TRUE | FALSE>, <sslport=64-Bit-Ganzzahl>, <sslrequired=TRUE | FALSE>;
Einstellungen
ParameterBeschreibung
hostGibt den Server an, mit dem sich CAS auf AWS verbindet.
nameGibt einen eindeutigen Namen für die Region an, die Sie hinzufügen oder ersetzen.
nosslGibt an, dass SSL oder TLS während der Datenübertragung deaktiviert ist.
portGibt den HTTP-Port an, zu dem ohne Verwendung von SSL eine Verbindung hergestellt werden soll. Wenn Sie keinen Portwert angeben, wird der Standardwert verwendet.
regionGibt den Regionscode der Region an, die Sie hinzufügen oder ersetzen.
sslallowedGibt an, dass SSL bei der Kommunikation mit der S3-Umgebung zulässig ist. Dieser Wert wird ignoriert, wenn der Parameter SSLREQUIRED angegeben ist.
sslportGibt den HTTP-Port an, zu dem eine Verbindung mit S3 über SSL hergestellt werden soll. Wenn Sie keinen Portwert angeben, wird der Standardwert verwendet.
sslrequiredGibt an, dass die gesamte Kommunikation mit der S3-Umgebung über SSL erfolgt.
Datenaufbereitung
Keine Datenerstellung erforderlich

Die Aktionen des 's3'-Aktionssatzes erfordern keine vorherige Datenerstellung, da sie zur Verwaltung der Konfiguration der CAS-Sitzung in Bezug auf S3-Regionen verwendet werden.

/* Für diese Aktion ist keine Datenerstellung erforderlich. */

Beispiele

Dieses Beispiel zeigt, wie man eine neue S3-Region mit nur den erforderlichen Parametern hinzufügt: Name und Host. Dies ist nützlich für einen schnellen Aufbau mit einem S3-kompatiblen Speicher, der Standard-Ports und SSL-Einstellungen verwendet.

SAS® / CAS-Code
Kopiert!
1PROC CAS;
2 S3.addRegion /
3 name="mein-benutzerdefinierter-speicher"
4 host="s3.mein-unternehmen.com";
5RUN;
Ergebnis :
Die Aktion fügt die neue Region zur CAS-Sitzungskonfiguration hinzu. Eine Erfolgsmeldung wird im Protokoll angezeigt, die bestätigt, dass die Region hinzugefügt wurde.

Dieses Beispiel zeigt, wie man eine benutzerdefinierte S3-Region mit allen verfügbaren Optionen hinzufügt. Es gibt einen eindeutigen Namen, einen Host, einen spezifischen Regionscode, erzwingt SSL auf einem bestimmten Port und deaktiviert Nicht-SSL-Verbindungen. Dies ist ein typisches Szenario für Produktionsumgebungen, die eine strenge Sicherheits- und Netzwerkkonfiguration erfordern.

SAS® / CAS-Code
Kopiert!
1PROC CAS;
2 S3.addRegion /
3 name="sicherer-interner-s3"
4 host="s3.intern.mein-unternehmen.de"
5 region="de-intern-1"
6 port=8080
7 sslport=8443
8 sslrequired=true
9 nossl=true; /* Deaktiviert explizit Nicht-SSL-Versuche */
10RUN;
Ergebnis :
Die Aktion konfiguriert eine neue Region namens 'sicherer-interner-s3'. CAS wird angewiesen, sich über Port 8443 mit SSL mit 's3.intern.mein-unternehmen.de' zu verbinden. Die Kommunikation über den Nicht-SSL-Port 8080 wird deaktiviert. Das Protokoll bestätigt die erfolgreiche Registrierung dieser detaillierten Konfiguration.

FAQ

Was bewirkt die Aktion 'addRegion'?
Welchen Zweck hat der Parameter 'host'?
Welchen Zweck hat der Parameter 'name'?
Welchen Zweck hat der Parameter 'nossl'?
Welchen Zweck hat der Parameter 'port'?
Welchen Zweck hat der Parameter 'region'?
Welchen Zweck hat der Parameter 'sslallowed'?
Welchen Zweck hat der Parameter 'sslport'?
Welchen Zweck hat der Parameter 'sslrequired'?

Zugehörige Szenarien

Anwendungsfall
Anbindung eines internen S3-kompatiblen Speichers für regulatorisches Reporting

Ein Finanzdienstleistungsunternehmen richtet einen neuen Data Lake auf einem intern gehosteten, S3-kompatiblen Speicher (z. B. MinIO) ein. CAS muss konfiguriert werden, um auf d...

Anwendungsfall
Aktualisierung einer bestehenden S3-Region während des Betriebs nach einer Infrastrukturmigration

Ein großes Einzelhandelsunternehmen migriert seine S3-Infrastruktur. Der Hostname für den primären Data Lake ändert sich. Gleichzeitig wird aus Sicherheitsgründen von einer Nich...

Anwendungsfall
Test der Fehlerbehandlung bei widersprüchlicher oder unvollständiger S3-Regionskonfiguration

Ein Junior Data Engineer in einem Pharmaforschungsunternehmen versucht, eine Verbindung zu einer neuen, experimentellen S3-Datenquelle herzustellen. Er ist mit der genauen Netzw...