Amazon Redshift unterstützt ab dem 1. November 2025 nicht mehr die Erstellung neuer Python-UDFs. Wenn Sie Python-UDFs verwenden möchten, erstellen Sie die UDFs vor diesem Datum. Bestehende Python-UDFs funktionieren weiterhin wie gewohnt. Weitere Informationen finden Sie im Blog-Posting.

Migrieren eines bereitgestellten Clusters zu Amazon Redshift Serverless

Sie können vorhandene bereitgestellte Cluster zu Amazon Redshift Serverless migrieren, um die automatische oder On-Demand-Skalierung der Rechenressourcen zu ermöglichen. Durch die Migration eines bereitgestellten Clusters zu Amazon Redshift Serverless können Sie die Kosten optimieren, indem Sie nur für die von Ihnen genutzten Ressourcen zahlen und die Kapazitäten automatisch auf Grundlage der Workload-Anforderungen skalieren. Zu den häufigsten Anwendungsfällen für die Migration gehören die Ausführung von Ad-hoc-Abfragen, regelmäßige Datenverarbeitungsaufträge oder die Verarbeitung nicht planbarer Workloads ohne Überdimensionierung von Ressourcen. Führen Sie die folgenden Aufgaben aus, um den bereitgestellten Amazon-Redshift-Cluster zur Serverless-Bereitstellungsoption zu migrieren.

Erstellen eines Snapshots des bereitgestellten Clusters

Um Daten von Ihrem bereitgestellten Cluster zu Amazon Redshift Serverless zu übertragen, erstellen Sie einen Snapshot Ihres bereitgestellten Clusters und stellen diesen dann in Amazon Redshift Serverless wieder her.

Weitere Informationen zu bereitgestellten Cluster-Snapshots finden Sie unter Amazon-Redshift-Snapshots.

Herstellen einer Verbindung mit Amazon Redshift Serverless über einen Treiber

Um über Ihren bevorzugten SQL-Client eine Verbindung zu Amazon Redshift Serverless herzustellen, können Sie die von Amazon Redshift bereitgestellte JDBC-Treiberversion 2.x verwenden. Wir empfehlen, die Verbindung zu Amazon Redshift über die neueste Version der JDBC-Treiberversion 2.x von Amazon-Redshift herzustellen. Der Portnummer ist optional. Wenn Sie keine Angaben machen, verwendet Amazon Redshift Serverless standardmäßig die Portnummer 5439. Sie können zu einem anderen Port aus dem Portbereich 5431–5455 oder 8191–8215 wechseln. Verwenden Sie die AWS CLI und die Amazon-Redshift-API, um den Standardport für einen Serverless-Endpunkt zu ändern.

Den genauen Endpunkt für den JDBC-, ODBC- oder Python-Treiber finden Sie unter Arbeitsgruppenkonfiguration in Amazon Redshift Serverless. Sie können auch die API-Operation GetWorkgroup in Amazon Redshift Serverless oder die AWS CLI-Operation get-workgroups verwenden, um Informationen über Ihre Arbeitsgruppe zurückzugeben, und dann eine Verbindung herstellen.

Verbinden mit passwortbasierter Authentifizierung

Verwenden Sie die folgende Syntax, um eine Verbindung über die JDBC-Treiberversion 2.x von Amazon Redshift mit passwortbasierter Authentifizierung herzustellen:

jdbc:redshift://<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com:5439/?username=username&password=password

Verwenden Sie die folgende Syntax, um eine Verbindung über den Python-Konnektor von Amazon Redshift mit passwortbasierter Authentifizierung herzustellen:

import redshift_connector
with redshift_connector.connect(
    host='<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com',
    database='<database-name>',
    user='username',
    password='password'
    # port value of 5439 is specified by default
) as conn:
    pass

Verwenden Sie die folgende Syntax, um eine Verbindung über die ODBC-Treiberversion 2.x von Amazon Redshift mit passwortbasierter Authentifizierung herzustellen:

Driver={Amazon Redshift ODBC Driver (x64)}; Server=<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com; Database=database-name; User=username; Password=password

Herstellen einer Verbindung über IAM

Wenn Sie sich mit IAM anmelden möchten, verwenden Sie die API-Operation GetCredentials von Amazon Redshift Serverless.

Um die IAM-Authentifizierung zu verwenden, fügen Sie der JDBC-URL von Amazon Redshift nach jdbc:redshift: das Element iam: hinzu wie im folgenden Beispiel gezeigt.

jdbc:redshift:iam://<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com:5439/<database-name>

Dieser Endpunkt in Amazon Redshift Serverless unterstützt keine Anpassung von dbUser, dbGroup oder auto-create. Standardmäßig erstellt der Treiber automatisch Datenbankbenutzer bei der Anmeldung. Anschließend werden den Benutzern Amazon-Redshift-Datenbankrollen zugewiesen, basierend auf den in IAM angegebenen Tags oder basierend auf den in Ihrem Identitätsanbieter (IdP) definierten Gruppen.

Stellen Sie sicher, dass Ihre AWS-Identität über die richtige IAM-Richtlinie für die redshift-serverless:GetCredentials-Aktion verfügt. Im Folgenden finden Sie ein Beispiel für eine IAM-Richtlinie, die einer AWS-Identität die richtigen Berechtigungen zum Herstellen einer Verbindung zu Amazon Redshift Serverless gewährt. Weitere Informationen zu IAM-Berechtigungen finden Sie unter Hinzufügen und Entfernen von IAM-Identitätsberechtigungen im IAM-Benutzerhandbuch.

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": "redshift-serverless:GetCredentials",
            "Resource": "*"
        }
    ]
}

Um eine Verbindung über den Python-Konnektor von Amazon Redshift mit IAM-basierter Authentifizierung herzustellen, verwenden Sie iam=true im Code wie in der folgenden Syntax gezeigt:

import redshift_connector
with redshift_connector.connect(
    iam=True,
    host='<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com',
    database='<database-name>'
    <IAM credentials>
) as conn:
    pass

Für IAM credentials können Sie beliebige Anmeldeinformationen verwenden, einschließlich der folgenden:

Verwenden Sie die folgende Syntax, um eine Verbindung über die ODBC-Treiberversion 2.x von Amazon Redshift mit IAM-basierter Authentifizierung und einem Profil herzustellen:

Driver={Amazon Redshift ODBC Driver (x64)}; IAM=true; Server=<workgroup-name>.<account-number>.<aws-region>.redshift-serverless.amazonaws.com; Database=database-name; Profile=aws-profile-name;

Herstellen einer Verbindung über IAM mittels der API GetClusterCredentials

Sie können mithilfe der API GetClusterCredentials eine Verbindung zu Amazon Redshift Serverless herstellen. Um diese Authentifizierungsmethode zu implementieren, ändern Sie Ihren Client oder Ihre Anwendung, indem Sie die folgenden Parameter integrieren:

Die folgenden Beispiele zeigen das BrowserSAML-Plugin für alle drei Treiber. Dies stellt einen von mehreren verfügbaren Authentifizierungsansätzen dar. Die Beispiele können geändert werden, um abhängig von Ihren spezifischen Anforderungen alternative Authentifizierungsmethoden oder Plugins zu verwenden.

IAM-Richtlinienberechtigungen für GetClusterCredentials

Im Folgenden finden Sie ein Beispiel für eine IAM-Richtlinie mit den Berechtigungen, die für die Verwendung von GetClusterCredentials mit Amazon Redshift Serverless erforderlich sind:

JSON

{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "VisualEditor0",
            "Effect": "Allow",
            "Action": [
                "redshift-serverless:GetWorkgroup",
                "redshift-serverless:GetNamespace",
                "redshift:GetClusterCredentials",
                "redshift:CreateClusterUser",
                "redshift:JoinGroup",
                "redshift:ExecuteQuery",
                "redshift:FetchResults",
                "redshift:DescribeClusters",
                "redshift:DescribeTable"
            ],
            "Resource": [
                "arn:aws:redshift-serverless:us-east-1:111122223333:workgroup/workgroup-name",
                "arn:aws:redshift-serverless:us-east-1:111122223333:namespace/namespace-name",
                "arn:aws:redshift:us-east-1:111122223333:cluster:cluster-name",
                "arn:aws:redshift:us-east-1:111122223333:dbuser:database-name/${redshift:DbUser}"
            ]
        }
    ]
}

Verwenden Sie die folgende Syntax, um über die JDBC-Treiberversion 2.x von Amazon Redshift eine Verbindung mit GetClusterCredentials herzustellen:

jdbc:redshift:iam://redshift-serverless-<workgroup-name>:<aws-region>/<database-name>?plugin_name=com.amazon.redshift.plugin.BrowserSamlCredentialsProvider&login_url=<single sign-on URL from IdP>"

Verwenden Sie die folgende Syntax, um über den Python-Konnektor von Amazon Redshift eine Verbindung mit GetClusterCredentials herzustellen:

import redshift_connector
with redshift_connector.connect(
    iam=True,
    cluster_identifier='redshift-serverless-<workgroup-name>',
    region='<aws-region>',
    database='<database-name>',
    credentials_provider='BrowserSamlCredentialsProvider'
    login_url='<single sign-on URL from IdP>'
    # port value of 5439 is specified by default
) as conn:
    pass

Verwenden Sie die folgende Syntax, um über die ODBC-Treiberversion 2.x von Amazon Redshift eine Verbindung mit GetClusterCredentials herzustellen:

Driver= {Amazon Redshift ODBC Driver (x64)}; IAM=true; isServerless=true; ClusterId=redshift-serverless-<workgroup-name>; region=<aws-region>; plugin_name=BrowserSAML;login_url=<single sign-on URL from IdP>

Im Folgenden finden Sie ein Beispiel für eine ODBC-DSN-Konfiguration in Windows:

Verwenden des Amazon-Redshift-Serverless-SDK

Wenn Sie Verwaltungsskripte mit dem Amazon-Redshift-SDK geschrieben haben, müssen Sie das neue Amazon-Redshift-Serverless-SDK verwenden, um Amazon Redshift Serverless und zugehörige Ressourcen zu verwalten. Weitere Informationen zu verfügbaren API-Operationen finden Sie im API-Referenzhandbuch zu Amazon Redshift Serverless.