Beispiele für die Verwendung von Amazon Redshift mit AWS CLI

So akzeptieren Sie den Austausch eines reservierten Knotens

Im folgenden Beispiel für accept-reserved-node-exchange wird der Austausch von einem reservierten DC1-Knoten gegen einen reservierten DC2-Knoten akzeptiert.

aws redshift accept-reserved-node-exchange /
    --reserved-node-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE /
    --target-reserved-node-offering-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE

Ausgabe:

{
    "ExchangedReservedNode": {
        "ReservedNodeId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE",
        "ReservedNodeOfferingId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE",
        "NodeType": "dc2.large",
        "StartTime": "2019-12-06T21:17:26Z",
        "Duration": 31536000,
        "FixedPrice": 0.0,
        "UsagePrice": 0.0,
        "CurrencyCode": "USD",
        "NodeCount": 1,
        "State": "exchanging",
        "OfferingType": "All Upfront",
        "RecurringCharges": [
            {
                "RecurringChargeAmount": 0.0,
                "RecurringChargeFrequency": "Hourly"
            }
        ],
        "ReservedNodeOfferingType": "Regular"
    }
}

Weitere Informationen finden Sie unter Upgrade von reservierten Knoten mit der AWS-CLI im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Autorisieren des Zugriffs auf eine EC2-SicherheitsgruppeDieses Beispiel autorisiert den Zugriff auf eine benannte Amazon EC2-Sicherheitsgruppe. Befehl:

aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --ec2-security-group-name myec2securitygroup --ec2-security-group-owner-id 123445677890

Autorisieren des Zugriffs auf einen CIDR-Bereich Dieses Beispiel autorisiert den Zugriff auf einen CIDR-Bereich. Befehl:

aws redshift authorize-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32

Autorisieren Sie ein AWS-Konto für Wiederherstellung eines SnapshotsIn diesem Beispiel wird das AWS-Konto 444455556666 autorisiert, den Snapshot my-snapshot-id wiederherzustellen. JSON ist das Standardausgabeformat. Befehl:

aws redshift authorize-snapshot-access --snapshot-id my-snapshot-id --account-with-restore-access 444455556666

Ergebnis:

{
   "Snapshot": {
      "Status": "available",
      "SnapshotCreateTime": "2013-07-17T22:04:18.947Z",
      "EstimatedSecondsToCompletion": 0,
      "AvailabilityZone": "us-east-1a",
      "ClusterVersion": "1.0",
      "MasterUsername": "adminuser",
      "Encrypted": false,
      "OwnerAccount": "111122223333",
      "BackupProgressInMegabytes": 11.0,
      "ElapsedTimeInSeconds": 0,
      "DBName": "dev",
      "CurrentBackupRateInMegabytesPerSecond: 0.1534,
      "ClusterCreateTime": "2013-01-22T21:59:29.559Z",
      "ActualIncrementalBackupSizeInMegabytes"; 11.0,
      "SnapshotType": "manual",
      "NodeType": "dw.hs1.xlarge",
      "ClusterIdentifier": "mycluster",
      "TotalBackupSizeInMegabytes": 20.0,
      "Port": 5439,
      "NumberOfNodes": 2,
      "SnapshotIdentifier": "my-snapshot-id"
   }
}

So löschen Sie einen Cluster-Snapshot-Satz

Im folgenden Beispiel für batch-delete-cluster-snapshots wird ein Satz manueller Cluster-Snapshots gelöscht.

aws redshift batch-delete-cluster-snapshots \
        --identifiers SnapshotIdentifier=mycluster-2019-11-06-14-12 SnapshotIdentifier=mycluster-2019-11-06-14-20

Ausgabe:

{
    "Resources": [
        "mycluster-2019-11-06-14-12",
        "mycluster-2019-11-06-14-20"
    ]
}

Weitere Informationen finden Sie unter Amazon-Redshift-Snapshots im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So ändern Sie einen Satz von Cluster-Snapshots

Im folgenden Beispiel für batch-modify-cluster-snapshots werden die Einstellungen für einen Satz von Cluster-Snapshots geändert.

aws redshift batch-modify-cluster-snapshots \
    --snapshot-identifier-list mycluster-2019-11-06-16-31 mycluster-2019-11-06-16-32 \
    --manual-snapshot-retention-period 30

Ausgabe:

{
    "Resources": [
        "mycluster-2019-11-06-16-31",
        "mycluster-2019-11-06-16-32"
    ],
    "Errors": [],
    "ResponseMetadata": {
        "RequestId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE",
        "HTTPStatusCode": 200,
        "HTTPHeaders": {
                "x-amzn-requestid": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE,
                "content-type": "text/xml",
                "content-length": "480",
                "date": "Sat, 07 Dec 2019 00:36:09 GMT",
                "connection": "keep-alive"
        },
        "RetryAttempts": 0
    }
}

Weitere Informationen finden Sie unter Amazon-Redshift-Snapshots im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So brechen Sie die Größenänderung eines Clusters ab

Im folgenden Beispiel für cancel-resize wird eine klassische Größenänderungsoperation für einen Cluster abgebrochen.

aws redshift cancel-resize \
    --cluster-identifier mycluster

Ausgabe:

{
    "TargetNodeType": "dc2.large",
    "TargetNumberOfNodes": 2,
    "TargetClusterType": "multi-node",
    "Status": "CANCELLING",
    "ResizeType": "ClassicResize",
    "TargetEncryptionType": "NONE"
}

Weitere Informationen finden Sie unter Größenanpassung von Clustern in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Eine Beschreibung aller Cluster-Versionen abrufenDieses Beispiel gibt eine Beschreibung aller Cluster-Versionen zurück. JSON ist das Standardausgabeformat. Befehl:

aws redshift copy-cluster-snapshot --source-snapshot-identifier cm:examplecluster-2013-01-22-19-27-58 --target-snapshot-identifier my-saved-snapshot-copy

Ergebnis:

{
   "Snapshot": {
      "Status": "available",
      "SnapshotCreateTime": "2013-01-22T19:27:58.931Z",
      "AvailabilityZone": "us-east-1c",
      "ClusterVersion": "1.0",
      "MasterUsername": "adminuser",
      "DBName": "dev",
      "ClusterCreateTime": "2013-01-22T19:23:59.368Z",
      "SnapshotType": "manual",
      "NodeType": "dw.hs1.xlarge",
      "ClusterIdentifier": "examplecluster",
      "Port": 5439,
      "NumberOfNodes": "2",
      "SnapshotIdentifier": "my-saved-snapshot-copy"
   },
   "ResponseMetadata": {
      "RequestId": "3b279691-64e3-11e2-bec0-17624ad140dd"
   }
}

Eine Cluster-Parametergruppe erstellenIn diesem Beispiel wird eine neue Cluster-Parametergruppe erstellt. Befehl:

aws redshift create-cluster-parameter-group --parameter-group-name myclusterparametergroup --parameter-group-family redshift-1.0 --description "My first cluster parameter group"

Ergebnis:

{
   "ClusterParameterGroup": {
      "ParameterGroupFamily": "redshift-1.0",
      "Description": "My first cluster parameter group",
      "ParameterGroupName": "myclusterparametergroup"
   },
   "ResponseMetadata": {
      "RequestId": "739448f0-64cc-11e2-8f7d-3b939af52818"
   }
}

Eine Cluster-Sicherheitsgruppe erstellenIn diesem Beispiel wird eine neue Cluster-Sicherheitsgruppe erstellt. JSON ist das Standardausgabeformat. Befehl:

aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group"

Ergebnis:

{
   "create_cluster_security_group_response": {
      "create_cluster_security_group_result": {
         "cluster_security_group": {
            "description": "This is my cluster security group",
            "owner_id": "300454760768",
            "cluster_security_group_name": "mysecuritygroup",
            "ec2_security_groups": \[],
            "ip_ranges": \[]
         }
      },
      "response_metadata": {
         "request_id": "5df486a0-343a-11e2-b0d8-d15d0ef48549"
      }
   }
}

Sie können dieselben Informationen auch mit der --output text-Option im Textformat abrufen. Befehl:

--output text-Option. Befehl:

Option. Befehl:

aws redshift create-cluster-security-group --cluster-security-group-name mysecuritygroup --description "This is my cluster security group" --output text

Ergebnis:

This is my cluster security group   300454760768    mysecuritygroup
a0c0bfab-343a-11e2-95d2-c3dc9fe8ab57

Einen Cluster-Snapshot erstellenIn diesem Beispiel wird ein neuer Cluster-Snapshot erstellt. JSON ist das Standardausgabeformat. Befehl:

aws redshift create-cluster-snapshot --cluster-identifier mycluster --snapshot-identifier my-snapshot-id

Ergebnis:

{
   "Snapshot": {
      "Status": "creating",
      "SnapshotCreateTime": "2013-01-22T22:20:33.548Z",
      "AvailabilityZone": "us-east-1a",
      "ClusterVersion": "1.0",
      "MasterUsername": "adminuser",
      "DBName": "dev",
      "ClusterCreateTime": "2013-01-22T21:59:29.559Z",
      "SnapshotType": "manual",
      "NodeType": "dw.hs1.xlarge",
      "ClusterIdentifier": "mycluster",
      "Port": 5439,
      "NumberOfNodes": "2",
      "SnapshotIdentifier": "my-snapshot-id"
   },
   "ResponseMetadata": {
      "RequestId": "f024d1a5-64e1-11e2-88c5-53eb05787dfb"
   }
}

Eine Cluster-Subnetzgruppe erstellenIn diesem Beispiel wird eine neue Cluster-Subnetzgruppe erstellt. Befehl:

aws redshift create-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup  --description "My subnet group" --subnet-ids subnet-763fdd1c

Ergebnis:

{
   "ClusterSubnetGroup": {
      "Subnets": [
         {
            "SubnetStatus": "Active",
            "SubnetIdentifier": "subnet-763fdd1c",
            "SubnetAvailabilityZone": {
               "Name": "us-east-1a"
            }
         } ],
      "VpcId": "vpc-7e3fdd14",
      "SubnetGroupStatus": "Complete",
      "Description": "My subnet group",
      "ClusterSubnetGroupName": "mysubnetgroup"
   },
   "ResponseMetadata": {
      "RequestId": "500b8ce2-698f-11e2-9790-fd67517fb6fd"
   }
}

Einen Cluster mit minimalen Parametern erstellenIn diesem Beispiel wird ein Cluster mit einem minimalen Satz von Parametern erstellt. JSON ist das Standardausgabeformat. Befehl:

aws redshift create-cluster --node-type dw.hs1.xlarge --number-of-nodes 2 --master-username adminuser --master-user-password TopSecret1 --cluster-identifier mycluster

Ergebnis:

{
   "Cluster": {
      "NodeType": "dw.hs1.xlarge",
      "ClusterVersion": "1.0",
      "PubliclyAccessible": "true",
      "MasterUsername": "adminuser",
      "ClusterParameterGroups": [
         {
            "ParameterApplyStatus": "in-sync",
            "ParameterGroupName": "default.redshift-1.0"
         } ],
      "ClusterSecurityGroups": [
         {
            "Status": "active",
            "ClusterSecurityGroupName": "default"
         } ],
      "AllowVersionUpgrade": true,
      "VpcSecurityGroups": \[],
      "PreferredMaintenanceWindow": "sat:03:30-sat:04:00",
      "AutomatedSnapshotRetentionPeriod": 1,
      "ClusterStatus": "creating",
      "ClusterIdentifier": "mycluster",
      "DBName": "dev",
      "NumberOfNodes": 2,
      "PendingModifiedValues": {
         "MasterUserPassword": "\****"
      }
   },
   "ResponseMetadata": {
      "RequestId": "7cf4bcfc-64dd-11e2-bea9-49e0ce183f07"
   }
}

So erstellen Sie ein Benachrichtigungsabonnement für ein Ereignis

Im folgenden Beispiel für create-event-subscription wird ein Benachrichtigungsabonnement für ein Ereignis erstellt.

aws redshift create-event-subscription \
    --subscription-name mysubscription \
    --sns-topic-arn arn:aws:sns:us-west-2:123456789012:MySNStopic \
    --source-type cluster \
    --source-ids mycluster

Ausgabe:

{
        "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "mysubscription",
        "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic",
        "Status": "active",
        "SubscriptionCreationTime": "2019-12-09T20:05:19.365Z",
        "SourceType": "cluster",
        "SourceIdsList": [
            "mycluster"
        ],
        "EventCategoriesList": [],
        "Severity": "INFO",
        "Enabled": true,
        "Tags": []
    }
}

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So erstellen Sie ein HSM-Client-Zertifikat

Im folgenden Beispiel für create-hsm-client-certificate wird ein HSM-Client-Zertifikat generiert, das ein Cluster verwenden kann, um eine Verbindung zu einem HSM herzustellen.

aws redshift create-hsm-client-certificate \
    --hsm-client-certificate-identifier myhsmclientcert

Ausgabe:

{
    "HsmClientCertificate": {
        "HsmClientCertificateIdentifier": "myhsmclientcert",
        "HsmClientCertificatePublicKey": "-----BEGIN CERTIFICATE-----
        MIICiEXAMPLECQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
        VVMxCzAJBgNVBAgTEXAMPLEwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
        b24xFDASBgNVBAsTC0lBTSBDb25EXAMPLEIwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
        BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb2EXAMPLETEwNDI1MjA0NTIxWhcN
        MTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBEXAMPLEMRAwDgYD
        EXAMPLETZWF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
        b2xlMRIwEAEXAMPLEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFt
        YXpvbi5jb20wgZ8wDQYJKEXAMPLEAQEBBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ
        21uUSfwfEvySWtC2XADZ4nB+BLYgVIk6EXAMPLE3G93vUEIO3IyNoH/f0wYK8m9T
        rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugEXAMPLEzZswY6786m86gpE
        Ibb3OhjZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEEXAMPLEEAtCu4
        nUhVVxYUEXAMPLEh8Mg9q6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
        FFBjvSfpJIlJ00zbhNYS5f6GEXAMPLEl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTb
        NYiytVbZPQUQ5Yaxu2jXnimvw3rEXAMPLE=-----END CERTIFICATE-----\n",
    "Tags": []
    }
}

Weitere Informationen finden Sie unter Referenz für API-Berechtigungen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So erstellen Sie eine HSM-Konfiguration

Im folgenden Beispiel für create-hsm-configuration wird die angegebene HSM-Konfiguration erstellt, die Informationen enthält, die ein Cluster benötigt, um Datenbank-Verschlüsselungsschlüssel in einem Hardware-Sicherheitsmodul (HSM) zu speichern und zu verwenden.

aws redshift create-hsm-configuration /
    --hsm-configuration-identifier myhsmconnection
    --description "My HSM connection"
    --hsm-ip-address 192.0.2.09
    --hsm-partition-name myhsmpartition /
    --hsm-partition-password A1b2c3d4 /
    --hsm-server-public-certificate myhsmclientcert

Ausgabe:

{
    "HsmConfiguration": {
        "HsmConfigurationIdentifier": "myhsmconnection",
        "Description": "My HSM connection",
        "HsmIpAddress": "192.0.2.09",
        "HsmPartitionName": "myhsmpartition",
        "Tags": []
    }
}

So erstellen Sie eine Snapshot-Kopierberechtigung

Im folgenden Beispiel für create-snapshot-copy-grant wird eine Snapshot-Kopierberechtigung erstellt und die kopierten Snapshots werden in einer AWS-Zielregion verschlüsselt.

aws redshift create-snapshot-copy-grant \
    --snapshot-copy-grant-name mysnapshotcopygrantname

Ausgabe:

{
    "SnapshotCopyGrant": {
        "SnapshotCopyGrantName": "mysnapshotcopygrantname",
        "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
        "Tags": []
    }
}

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So erstellen Sie einen Snapshot-Zeitplan

Im folgenden Beispiel für create-snapshot-schedule wird ein Snapshot-Zeitplan mit der angegebenen Beschreibung und einer Intervallrate von 12 Stunden erstellt.

aws redshift create-snapshot-schedule \
    --schedule-definitions "rate(12 hours)" \
    --schedule-identifier mysnapshotschedule \
    --schedule-description "My schedule description"

Ausgabe:

{
    "ScheduleDefinitions": [
        "rate(12 hours)"
    ],
    "ScheduleIdentifier": "mysnapshotschedule",
    "ScheduleDescription": "My schedule description",
    "Tags": []
}

Weitere Informationen finden Sie unter Automatisierte Snapshot-Zeitpläne im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So erstellen Sie Tags für ein Cluster

Im folgenden Beispiel für create-tags wird das angegebene Tag-Schlüssel/Wert-Paar zum angegebenen Cluster hinzugefügt.

aws redshift create-tags \
    --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
    --tags "Key"="mytags","Value"="tag1"

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Markieren von Ressourcen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Eine Cluster-Parametergruppe löschenIn diesem Beispiel wird eine Cluster-Parametergruppe gelöscht. Befehl:

aws redshift delete-cluster-parameter-group --parameter-group-name myclusterparametergroup

Eine Cluster-Sicherheitsgruppe löschenIn diesem Beispiel wird eine Cluster-Sicherheitsgruppe gelöscht. Befehl:

aws redshift delete-cluster-security-group --cluster-security-group-name mysecuritygroup

Einen Cluster-Snapshot löschenIn diesem Beispiel wird ein Cluster-Snapshot gelöscht. Befehl:

aws redshift delete-cluster-snapshot --snapshot-identifier my-snapshot-id

Eine Cluster-Subnetzgruppe löschenIn diesem Beispiel wird eine Cluster-Subnetzgruppe gelöscht. Befehl:

aws redshift delete-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup

Ergebnis:

{
   "ResponseMetadata": {
      "RequestId": "253fbffd-6993-11e2-bc3a-47431073908a"
   }
}

Einen Cluster ohne endgültigen Cluster-Snapshot löschenIn diesem Beispiel wird ein Cluster gelöscht, wodurch das Löschen von Daten erzwungen wird, damit kein endgültiger Cluster-Snapshot erstellt wird. Befehl:

aws redshift delete-cluster --cluster-identifier mycluster --skip-final-cluster-snapshot

Einen Cluster löschen und einen endgültigen Cluster-Snapshot zulassenIn diesem Beispiel wird ein Cluster gelöscht, es wird jedoch ein letzter Cluster-Snapshot spezifiziert. Befehl:

aws redshift delete-cluster --cluster-identifier mycluster --final-cluster-snapshot-identifier myfinalsnapshot

So löschen Sie ein Ereignisabonnement

Im folgenden Beispiel für delete-event-subscription wird das angegebene Benachrichtigungsabonnement für ein Ereignis gelöscht.

aws redshift delete-event-subscription \
    --subscription-name mysubscription

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So löschen Sie ein HSM-Clientzertifikat

Im folgenden Beispiel für delete-hsm-client-certificate wird ein HSM-Clientzertifikat gelöscht.

aws redshift delete-hsm-client-certificate \
    --hsm-client-certificate-identifier myhsmclientcert

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Referenz für API-Berechtigungen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So löschen Sie eine HSM-Konfiguration

Im folgenden Beispiel für delete-hsm-configuration wird die angegebene HSM-Konfiguration aus dem aktuellen AWS-Konto gelöscht.

aws redshift delete-hsm-configuration /
    --hsm-configuration-identifier myhsmconnection

Dieser Befehl erzeugt keine Ausgabe.

So löschen Sie eine geplante Aktion

Der folgende delete-scheduled-action-Befehl löscht die angegebene geplante Aktion.

aws redshift delete-scheduled-action \
    --scheduled-action-name myscheduledaction

Dieser Befehl erzeugt keine Ausgabe.

So löschen Sie eine Erteilung zum Kopieren von Snapshots

Das folgende Beispiel für delete-snapshot-copy-grant beschreibt die angegebene Erteilung zum Kopieren von Snapshots

aws redshift delete-snapshot-copy-grant \
    --snapshot-copy-grant-name mysnapshotcopygrantname

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So löschen Sie einen Snapshot-Zeitplan

Das folgende Beispiel für delete-snapshot-schedule beschreibt den angegebenen Snapshot-Zeitplan. Sie müssen die Cluster-Zuordnung aufheben, bevor Sie den Zeitplan löschen können.

aws redshift delete-snapshot-schedule \
    --schedule-identifier mysnapshotschedule

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Automatisierte Snapshot-Zeitpläne im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So löschen Sie Tags aus einem Cluster

Im folgenden Beispiel für delete-tags werden die Tags mit den angegebenen Schlüsselnamen aus dem angegebenen Cluster gelöscht.

aws redshift delete-tags \
    --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
    --tag-keys "clustertagkey" "clustertagvalue"

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Markieren von Ressourcen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So beschreiben Sie die Attribute eines AWS-Kontos

Im folgenden Beispiel für describe-account-attributes werden die Attribute angezeigt, die dem anrufenden AWS-Konto zugeordnet sind.

aws redshift describe-account-attributes

Ausgabe:

{
    "AccountAttributes": [
        {
            "AttributeName": "max-defer-maintenance-duration",
            "AttributeValues": [
                {
                    "AttributeValue": "45"
                }
            ]
        }
    ]
}

So beschreiben Sie DB-Revisionen für einen Cluster

Im folgenden Beispiel für describe-cluster-db-revisions werden die Details eines Arrays von ClusterDbRevision-Objekten für den angegebenen Cluster angezeigt.

aws redshift describe-cluster-db-revisions \
    --cluster-identifier mycluster

Ausgabe:

{
    "ClusterDbRevisions": [
        {
            "ClusterIdentifier": "mycluster",
            "CurrentDatabaseRevision": "11420",
            "DatabaseRevisionReleaseDate": "2019-11-22T16:43:49.597Z",
            "RevisionTargets": []
        }
    ]
}

Eine Beschreibung aller Cluster-Parametergruppen abrufenIn diesem Beispiel wird eine Beschreibung aller Cluster-Parametergruppen für das Konto inklusive Spaltenüberschriften zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-parameter-groups

Ergebnis:

{
   "ParameterGroups": [
      {
         "ParameterGroupFamily": "redshift-1.0",
         "Description": "My first cluster parameter group",
         "ParameterGroupName": "myclusterparametergroup"
      } ],
   "ResponseMetadata": {
      "RequestId": "8ceb8f6f-64cc-11e2-bea9-49e0ce183f07"
   }
}

Sie können dieselben Informationen auch mit der --output text-Option im Textformat abrufen. Befehl:

--output text-Option. Befehl:

Option. Befehl:

aws redshift describe-cluster-parameter-groups --output text

Ergebnis:

redshift-1.0        My first cluster parameter group        myclusterparametergroup
RESPONSEMETADATA    9e665a36-64cc-11e2-8f7d-3b939af52818

Die Parameter für eine angegebene Cluster-Parametergruppe abrufenIn diesem Beispiel werden die Parameter für die benannte Parametergruppe abgerufen. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup

Ergebnis:

{
   "Parameters": [
      {
         "Description": "Sets the display format for date and time values.",
         "DataType": "string",
         "IsModifiable": true,
         "Source": "engine-default",
         "ParameterValue": "ISO, MDY",
         "ParameterName": "datestyle"
      },
      {
         "Description": "Sets the number of digits displayed for floating-point values",
         "DataType": "integer",
         "IsModifiable": true,
         "AllowedValues": "-15-2",
         "Source": "engine-default",
         "ParameterValue": "0",
         "ParameterName": "extra_float_digits"
      },
      (...remaining output omitted...)
   ]
}

Sie können dieselben Informationen auch mit der --output text-Option im Textformat abrufen. Befehl:

--output text-Option. Befehl:

Option. Befehl:

aws redshift describe-cluster-parameters --parameter-group-name myclusterparametergroup --output text

Ergebnis:

RESPONSEMETADATA    cdac40aa-64cc-11e2-9e70-918437dd236d
Sets the display format for date and time values.   string  True    engine-default  ISO, MDY        datestyle
Sets the number of digits displayed for floating-point values       integer True    -15-2   engine-default  0       extra_float_digits
This parameter applies a user-defined label to a group of queries that are run during the same session..    string  True    engine-default  default query_group
require ssl for all databaseconnections     boolean True    true,false      engine-default  false   require_ssl
Sets the schema search order for names that are not schema-qualified.       string  True    engine-default  $user, public   search_path
Aborts any statement that takes over the specified number of milliseconds.  integer True    engine-default  0       statement_timeout
wlm json configuration      string  True    engine-default  \[{"query_concurrency":5}]      wlm_json_configuration

Eine Beschreibung aller Cluster-Sicherheitsgruppen abrufenIn diesem Beispiel wird eine Beschreibung aller Clustersicherheitsgruppen für das Konto zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-security-groups

Ergebnis:

{
   "ClusterSecurityGroups": [
      {
         "OwnerId": "100447751468",
         "Description": "default",
         "ClusterSecurityGroupName": "default",
         "EC2SecurityGroups": \[],
         "IPRanges": [
            {
               "Status": "authorized",
               "CIDRIP": "0.0.0.0/0"
            }
         ]
      },
      {
         "OwnerId": "100447751468",
         "Description": "This is my cluster security group",
         "ClusterSecurityGroupName": "mysecuritygroup",
         "EC2SecurityGroups": \[],
         "IPRanges": \[]
      },
      (...remaining output omitted...)
   ]
}

Eine Beschreibung aller Cluster-Snapshots abrufenIn diesem Beispiel wird eine Beschreibung aller Cluster-Snapshots für das Konto zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-snapshots

Ergebnis:

{
   "Snapshots": [
      {
         "Status": "available",
         "SnapshotCreateTime": "2013-07-17T22:02:22.852Z",
         "EstimatedSecondsToCompletion": -1,
         "AvailabilityZone": "us-east-1a",
         "ClusterVersion": "1.0",
         "MasterUsername": "adminuser",
         "Encrypted": false,
         "OwnerAccount": "111122223333",
         "BackupProgressInMegabytes": 20.0,
         "ElapsedTimeInSeconds": 0,
         "DBName": "dev",
         "CurrentBackupRateInMegabytesPerSecond: 0.0,
         "ClusterCreateTime": "2013-01-22T21:59:29.559Z",
         "ActualIncrementalBackupSizeInMegabytes"; 20.0
         "SnapshotType": "automated",
         "NodeType": "dw.hs1.xlarge",
         "ClusterIdentifier": "mycluster",
         "Port": 5439,
         "TotalBackupSizeInMegabytes": 20.0,
         "NumberOfNodes": "2",
         "SnapshotIdentifier": "cm:mycluster-2013-01-22-22-04-18"
      },
      {
         "EstimatedSecondsToCompletion": 0,
         "OwnerAccount": "111122223333",
         "CurrentBackupRateInMegabytesPerSecond: 0.1534,
         "ActualIncrementalBackupSizeInMegabytes"; 11.0,
         "NumberOfNodes": "2",
         "Status": "available",
         "ClusterVersion": "1.0",
         "MasterUsername": "adminuser",
         "AccountsWithRestoreAccess": [
            {
               "AccountID": "444455556666"
            } ],
         "TotalBackupSizeInMegabytes": 20.0,
         "DBName": "dev",
         "BackupProgressInMegabytes": 11.0,
         "ClusterCreateTime": "2013-01-22T21:59:29.559Z",
         "ElapsedTimeInSeconds": 0,
         "ClusterIdentifier": "mycluster",
         "SnapshotCreateTime": "2013-07-17T22:04:18.947Z",
         "AvailabilityZone": "us-east-1a",
         "NodeType": "dw.hs1.xlarge",
         "Encrypted": false,
         "SnapshotType": "manual",
         "Port": 5439,
         "SnapshotIdentifier": "my-snapshot-id"
      } ]
   }
   (...remaining output omitted...)

Eine Beschreibung aller Cluster-Subnetzgruppen abrufenIn diesem Beispiel wird eine Beschreibung aller Cluster-Subnetzgruppen zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-subnet-groups

Ergebnis:

{
   "ClusterSubnetGroups": [
      {
         "Subnets": [
            {
               "SubnetStatus": "Active",
               "SubnetIdentifier": "subnet-763fdd1c",
               "SubnetAvailabilityZone": {
                  "Name": "us-east-1a"
               }
            }
         ],
         "VpcId": "vpc-7e3fdd14",
         "SubnetGroupStatus": "Complete",
         "Description": "My subnet group",
         "ClusterSubnetGroupName": "mysubnetgroup"
      }
   ],
   "ResponseMetadata": {
      "RequestId": "37fa8c89-6990-11e2-8f75-ab4018764c77"
   }
}

So beschreiben Sie Cluster-Pfade

Im folgenden Beispiel für describe-cluster-tracks werden Details zu den verfügbaren Wartungspfaden angezeigt.

aws redshift describe-cluster-tracks \
    --maintenance-track-name current

Ausgabe:

{
    "MaintenanceTracks": [
        {
            "MaintenanceTrackName": "current",
            "DatabaseVersion": "1.0.11420",
            "UpdateTargets": [
                {
                    "MaintenanceTrackName": "preview_features",
                    "DatabaseVersion": "1.0.11746",
                    "SupportedOperations": [
                        {
                            "OperationName": "restore-from-cluster-snapshot"
                        }
                    ]
                },
                {
                    "MaintenanceTrackName": "trailing",
                    "DatabaseVersion": "1.0.11116",
                    "SupportedOperations": [
                        {
                            "OperationName": "restore-from-cluster-snapshot"
                        },
                        {
                            "OperationName": "modify-cluster"
                        }
                    ]
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter Auswählen der Cluster-Wartungspfade im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Eine Beschreibung aller Cluster-Versionen abrufenIn diesem Beispiel wird eine Beschreibung aller Cluster-Versionen zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-cluster-versions

Ergebnis:

{
   "ClusterVersions": [
      {
      "ClusterVersion": "1.0",
      "Description": "Initial release",
      "ClusterParameterGroupFamily": "redshift-1.0"
      } ],
   "ResponseMetadata": {
      "RequestId": "16a53de3-64cc-11e2-bec0-17624ad140dd"
   }
}

Eine Beschreibung aller Cluster abrufenIn diesem Beispiel wird eine Beschreibung aller Cluster für das Konto zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-clusters

Ergebnis:

{
   "Clusters": [
   {
      "NodeType": "dw.hs1.xlarge",
      "Endpoint": {
         "Port": 5439,
         "Address": "mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com"
      },
      "ClusterVersion": "1.0",
      "PubliclyAccessible": "true",
      "MasterUsername": "adminuser",
      "ClusterParameterGroups": [
         {
            "ParameterApplyStatus": "in-sync",
            "ParameterGroupName": "default.redshift-1.0"
         } ],
      "ClusterSecurityGroups": [
         {
            "Status": "active",
            "ClusterSecurityGroupName": "default"
         } ],
      "AllowVersionUpgrade": true,
      "VpcSecurityGroups": \[],
      "AvailabilityZone": "us-east-1a",
      "ClusterCreateTime": "2013-01-22T21:59:29.559Z",
      "PreferredMaintenanceWindow": "sat:03:30-sat:04:00",
      "AutomatedSnapshotRetentionPeriod": 1,
      "ClusterStatus": "available",
      "ClusterIdentifier": "mycluster",
      "DBName": "dev",
      "NumberOfNodes": 2,
      "PendingModifiedValues": {}
   } ],
   "ResponseMetadata": {
      "RequestId": "65b71cac-64df-11e2-8f5b-e90bd6c77476"
   }
}

Sie können dieselben Informationen auch mit der --output text-Option im Textformat abrufen. Befehl:

--output text-Option. Befehl:

Option. Befehl:

aws redshift describe-clusters --output text

Ergebnis:

dw.hs1.xlarge       1.0     true    adminuser       True    us-east-1a      2013-01-22T21:59:29.559Z        sat:03:30-sat:04:00     1       available       mycluster       dev     2
ENDPOINT    5439    mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com
in-sync     default.redshift-1.0
active      default
PENDINGMODIFIEDVALUES
RESPONSEMETADATA    934281a8-64df-11e2-b07c-f7fbdd006c67

Eine Beschreibung der Standard-Cluster-Parameter abrufenIn diesem Beispiel wird eine Beschreibung der Standard-Cluster-Parameter für die redshift-1.0-Familie zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-default-cluster-parameters --parameter-group-family redshift-1.0

Ergebnis:

{
   "DefaultClusterParameters": {
   "ParameterGroupFamily": "redshift-1.0",
   "Parameters": [
      {
         "Description": "Sets the display format for date and time values.",
         "DataType": "string",
         "IsModifiable": true,
         "Source": "engine-default",
         "ParameterValue": "ISO, MDY",
         "ParameterName": "datestyle"
      },
      {
         "Description": "Sets the number of digits displayed for floating-point values",
         "DataType": "integer",
         "IsModifiable": true,
         "AllowedValues": "-15-2",
         "Source": "engine-default",
         "ParameterValue": "0",
         "ParameterName": "extra_float_digits"
      },
      (...remaining output omitted...)
      ]
   }
}

Führen Sie den describe-cluster-parameter-groups-Befehl aus, um eine Liste der gültigen Parametergruppenfamilien anzuzeigen.

describe-cluster-parameter-groups-Befehl.

Befehl.

So beschreiben Sie Ereigniskategorien für einen Cluster

Im folgenden Beispiel für describe-event-categories werden Details zu den Ereigniskategorien für einen Cluster angezeigt.

aws redshift describe-event-categories \
    --source-type cluster

Ausgabe:

{
    "EventCategoriesMapList": [
        {
            "SourceType": "cluster",
            "Events": [
                {
                    "EventId": "REDSHIFT-EVENT-2000",
                    "EventCategories": [
                        "management"
                    ],
                    "EventDescription": "Cluster <cluster name> created at <time in UTC>.",
                    "Severity": "INFO"
                },
                {
                    "EventId": "REDSHIFT-EVENT-2001",
                    "EventCategories": [
                        "management"
                    ],
                    "EventDescription": "Cluster <cluster name> deleted at <time in UTC>.",
                    "Severity": "INFO"
                },
                {
                    "EventId": "REDSHIFT-EVENT-3625",
                    "EventCategories": [
                        "monitoring"
                    ],
                    "EventDescription": "The cluster <cluster name> can't be resumed with its previous elastic network interface <ENI id>. We will allocate a new elastic network interface and associate it with the cluster node.",
                    "Severity": "INFO"
                }
            ]
        }
    ]
}

So beschreiben Sie Ereignisabonnements

Im folgenden Beispiel für describe-event-subscriptions werden Ereignisbenachrichtigungsabonnements für das angegebene Abonnement angezeigt.

aws redshift describe-event-subscriptions \
    --subscription-name mysubscription

Ausgabe:

{
    "EventSubscriptionsList": [
        {
            "CustomerAwsId": "123456789012",
            "CustSubscriptionId": "mysubscription",
            "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic",
            "Status": "active",
            "SubscriptionCreationTime": "2019-12-09T21:50:21.332Z",
            "SourceIdsList": [],
            "EventCategoriesList": [
                "management"
            ],
            "Severity": "ERROR",
            "Enabled": true,
            "Tags": []
        }
    ]
}

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Alle Ereignisse beschreibenIn diesem Beispiel werden alle Ereignisse zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-events

Ergebnis:

{
   "Events": [
      {
      "Date": "2013-01-22T19:17:03.640Z",
      "SourceIdentifier": "myclusterparametergroup",
      "Message": "Cluster parameter group myclusterparametergroup has been created.",
      "SourceType": "cluster-parameter-group"
      } ],
   "ResponseMetadata": {
      "RequestId": "9f056111-64c9-11e2-9390-ff04f2c1e638"
   }
}

Sie können dieselben Informationen auch mit der --output text-Option im Textformat abrufen. Befehl:

--output text-Option. Befehl:

Option. Befehl:

aws redshift describe-events --output text

Ergebnis:

2013-01-22T19:17:03.640Z    myclusterparametergroup Cluster parameter group myclusterparametergroup has been created.       cluster-parameter-group
RESPONSEMETADATA    8e5fe765-64c9-11e2-bce3-e56f52c50e17

So beschreiben Sie HSM-Clientzertifikate

Im folgenden Beispiel für describe-hsm-client-certificates werden die Details für das angegebene HSM-Clientzertifikat angezeigt.

aws redshift describe-hsm-client-certificates \
    --hsm-client-certificate-identifier myhsmclientcert

Ausgabe:

{
    "HsmClientCertificates": [
        {
        "HsmClientCertificateIdentifier": "myhsmclientcert",
        "HsmClientCertificatePublicKey": "-----BEGIN CERTIFICATE-----\
        EXAMPLECAfICCQD6m7oRw0uXOjANBgkqhkiG9w0BAQUFADCBiDELMAkGA1UEBhMC
        VVMxCzAJBgNVBAEXAMPLERAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBbWF6
        b24xFDASBgNVBAsTC0lBTSBDb25zEXAMPLEwEAYDVQQDEwlUZXN0Q2lsYWMxHzAd
        BgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wHhEXAMPLEDI1MjA0EXAMPLEN
        EXAMPLE0MjA0NTIxWjCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYD
        VQQHEwdTZWF0dGEXAMPLEQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25z
        b2xlMRIwEAYDVQQDEwlUZXN0Q2lsEXAMPLEdBgkqhkiG9w0BCQEWEG5vb25lQGFt
        YXpvbi5jb20wgZ8wDQYJKoZIhvcNAQEBBQADgY0AMIEXAMPLEMaK0dn+a4GmWIWJ
        21uUSfwfEvySWtC2XADZ4nB+BLYgVIk60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9T
        rDHudUZg3qX4waLG5M43q7Wgc/MbQITxOUSQv7c7ugFFDzQGBzZswY67EXAMPLEE
        EXAMPLEZnzcvQAaRHhdlQWIMm2nrAgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4
        nUhVVxYUntneD9EXAMPLE6q+auNKyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0Fkb
        FFBjvSfpJIlJ00zbhNYS5f6GuoEDEXAMPLEBHjJnyp378OD8uTs7fLvjx79LjSTb
        NYiytVbZPQUQ5Yaxu2jXnimvw3rEXAMPLE=-----END CERTIFICATE-----\n",
        "Tags": []
        }
    ]
}

Weitere Informationen finden Sie unter Referenz für API-Berechtigungen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So beschreiben Sie HSM-Konfigurationen

Im folgenden Beispiel für describe-hsm-configurations werden Details zu den verfügbaren HSM-Konfigurationen für das anrufende AWS-Konto angezeigt.

aws redshift describe-hsm-configurations /
    --hsm-configuration-identifier myhsmconnection

Ausgabe:

{
    "HsmConfigurations": [
        {
            "HsmConfigurationIdentifier": "myhsmconnection",
            "Description": "My HSM connection",
            "HsmIpAddress": "192.0.2.09",
            "HsmPartitionName": "myhsmpartition",
            "Tags": []
        }
    ]
}

So beschreiben Sie den Protokollierungsstatus für einen Cluster

Im folgenden Beispiel für describe-logging-status wird angezeigt, ob Informationen wie Abfragen und Verbindungsversuche für einen Cluster protokolliert werden.

aws redshift describe-logging-status \
    --cluster-identifier mycluster

Ausgabe:

{
    "LoggingEnabled": false
}

Weitere Informationen finden Sie unter Datenbank-Auditprotokollierung im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So beschreiben Sie Knotenkonfigurationsoptionen

Im folgenden Beispiel für describe-node-configuration-options werden die Eigenschaften möglicher Knotenkonfigurationen wie Knotentyp, Anzahl der Knoten und Festplattenbelegung für den angegebenen Cluster-Snapshot angezeigt.

aws redshift describe-node-configuration-options \
    --action-type restore-cluster \
    --snapshot-identifier rs:mycluster-2019-12-09-16-42-43

Ausgabe:

{
    "NodeConfigurationOptionList": [
        {
            "NodeType": "dc2.large",
            "NumberOfNodes": 2,
            "EstimatedDiskUtilizationPercent": 19.61
        },
        {
            "NodeType": "dc2.large",
            "NumberOfNodes": 4,
            "EstimatedDiskUtilizationPercent": 9.96
        },
        {
            "NodeType": "ds2.xlarge",
            "NumberOfNodes": 2,
            "EstimatedDiskUtilizationPercent": 1.53
        },
        {
            "NodeType": "ds2.xlarge",
            "NumberOfNodes": 4,
            "EstimatedDiskUtilizationPercent": 0.78
        }
    ]
}

Weitere Informationen finden Sie unter Kaufen reservierter Amazon-Redshift-Knoten im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Beschreibung aller bestellbaren ClusteroptionenIn diesem Beispiel werden die Beschreibungen aller bestellbaren Clusteroptionen zurückgegeben. JSON ist das Standardausgabeformat. Befehl:

aws redshift describe-orderable-cluster-options

Ergebnis:

{
   "OrderableClusterOptions": [
      {
         "NodeType": "dw.hs1.8xlarge",
         "AvailabilityZones": [
            { "Name": "us-east-1a" },
            { "Name": "us-east-1b" },
            { "Name": "us-east-1c" } ],
         "ClusterVersion": "1.0",
         "ClusterType": "multi-node"
      },
      {
         "NodeType": "dw.hs1.xlarge",
         "AvailabilityZones": [
            { "Name": "us-east-1a" },
            { "Name": "us-east-1b" },
            { "Name": "us-east-1c" } ],
         "ClusterVersion": "1.0",
         "ClusterType": "multi-node"
      },
      {
      "NodeType": "dw.hs1.xlarge",
      "AvailabilityZones": [
         { "Name": "us-east-1a" },
         { "Name": "us-east-1b" },
         { "Name": "us-east-1c" } ],
      "ClusterVersion": "1.0",
      "ClusterType": "single-node"
      } ],
   "ResponseMetadata": {
      "RequestId": "f6000035-64cb-11e2-9135-ff82df53a51a"
   }
}

Sie können dieselben Informationen auch mit der --output text-Option im Textformat abrufen. Befehl:

--output text-Option. Befehl:

Option. Befehl:

aws redshift describe-orderable-cluster-options --output text

Ergebnis:

dw.hs1.8xlarge      1.0     multi-node
us-east-1a
us-east-1b
us-east-1c
dw.hs1.xlarge       1.0     multi-node
us-east-1a
us-east-1b
us-east-1c
dw.hs1.xlarge       1.0     single-node
us-east-1a
us-east-1b
us-east-1c
RESPONSEMETADATA    e648696b-64cb-11e2-bec0-17624ad140dd

Beschreiben der Angebote für reservierte KnotenIn diesem Beispiel werden alle Angebote für reservierte Knoten, die käuflich erworben werden können, angezeigt. Befehl:

aws redshift describe-reserved-node-offerings

Ergebnis:

{
   "ReservedNodeOfferings": [
      {
         "OfferingType": "Heavy Utilization",
         "FixedPrice": "",
         "NodeType": "dw.hs1.xlarge",
         "UsagePrice": "",
         "RecurringCharges": [
            {
               "RecurringChargeAmount": "",
               "RecurringChargeFrequency": "Hourly"
            } ],
         "Duration": 31536000,
         "ReservedNodeOfferingId": "ceb6a579-cf4c-4343-be8b-d832c45ab51c"
      },
      {
         "OfferingType": "Heavy Utilization",
         "FixedPrice": "",
         "NodeType": "dw.hs1.8xlarge",
         "UsagePrice": "",
         "RecurringCharges": [
            {
            "RecurringChargeAmount": "",
            "RecurringChargeFrequency": "Hourly"
            } ],
         "Duration": 31536000,
         "ReservedNodeOfferingId": "e5a2ff3b-352d-4a9c-ad7d-373c4cab5dd2"
      },
      ...remaining output omitted...
   ],
   "ResponseMetadata": {
      "RequestId": "8b1a1a43-75ff-11e2-9666-e142fe91ddd1"
   }
}

Wenn Sie ein Angebot für reservierte Knoten erwerben möchten, können Sie purchase-reserved-node-offering mit einer gültigen ReservedNodeOfferingId aufrufen.

purchase-reserved-node-offering mithilfe einer gültigen ReservedNodeOfferingId.

unter Verwendung einer gültigen ReservedNodeOfferingId.

ReservedNodeOfferingId.

.

Beschreiben reservierter KnotenIn diesem Beispiel wird ein Angebot für reservierte Knoten angezeigt, das gekauft wurde. Befehl:

aws redshift describe-reserved-nodes

Ergebnis:

{
   "ResponseMetadata": {
      "RequestId": "bc29ce2e-7600-11e2-9949-4b361e7420b7"
   },
   "ReservedNodes": [
      {
         "OfferingType": "Heavy Utilization",
         "FixedPrice": "",
         "NodeType": "dw.hs1.xlarge",
         "ReservedNodeId": "1ba8e2e3-bc01-4d65-b35d-a4a3e931547e",
         "UsagePrice": "",
         "RecurringCharges": [
            {
               "RecurringChargeAmount": "",
               "RecurringChargeFrequency": "Hourly"
            } ],
         "NodeCount": 1,
         "State": "payment-pending",
         "StartTime": "2013-02-13T17:08:39.051Z",
         "Duration": 31536000,
         "ReservedNodeOfferingId": "ceb6a579-cf4c-4343-be8b-d832c45ab51c"
      }
   ]
}

Größenänderung beschreibenIn diesem Beispiel wird die letzte Größenänderung eines Clusters beschrieben. Die Anfrage betraf 3 Knoten des Typs dw.hs1.8xlarge.-Befehl:

aws redshift describe-resize --cluster-identifier mycluster

Ergebnis:

{
   "Status": "NONE",
   "TargetClusterType": "multi-node",
   "TargetNodeType": "dw.hs1.8xlarge",
   "ResponseMetadata": {
      "RequestId": "9f52b0b4-7733-11e2-aa9b-318b2909bd27"
   },
   "TargetNumberOfNodes": "3"
}

So beschreiben Sie geplante Aktionen

Im folgenden Beispiel für describe-scheduled-actions werden Details zu allen derzeit geplanten Aktionen angezeigt.

aws redshift describe-scheduled-actions

Ausgabe:

{
    "ScheduledActions": [
        {
            "ScheduledActionName": "resizecluster",
            "TargetAction": {
                "ResizeCluster": {
                    "ClusterIdentifier": "mycluster",
                    "NumberOfNodes": 4,
                    "Classic": false
                }
            },
            "Schedule": "at(2019-12-10T00:07:00)",
            "IamRole": "arn:aws:iam::123456789012:role/myRedshiftRole",
            "State": "ACTIVE",
            "NextInvocations": [
                "2019-12-10T00:07:00Z"
            ]
        }
    ]
}

So beschreiben Sie Erteilungen zum Kopieren von Snapshots

Im folgenden Beispiel für describe-snapshot-copy-grants werden die Details für die angegebene Erteilung zum Kopieren von Snapshots angezeigt.

aws redshift describe-snapshot-copy-grants \
    --snapshot-copy-grant-name mysnapshotcopygrantname

Ausgabe:

{
    "SnapshotCopyGrants": [
        {
            "SnapshotCopyGrantName": "mysnapshotcopygrantname",
            "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
            "Tags": []
        }
    ]
}

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So beschreiben Sie Snapshot-Zeitpläne

Im folgenden Beispiel für describe-snapshot-schedules werden die Details für den angegebenen Cluster-Snapshot-Zeitplan angezeigt.

aws redshift describe-snapshot-schedules \
    --cluster-identifier mycluster \
    --schedule-identifier mysnapshotschedule

Ausgabe:

{
    "SnapshotSchedules": [
        {
            "ScheduleDefinitions": [
                "rate(12 hours)"
            ],
            "ScheduleIdentifier": "mysnapshotschedule",
            "ScheduleDescription": "My schedule description",
            "Tags": [],
            "AssociatedClusterCount": 1,
            "AssociatedClusters": [
                {
                    "ClusterIdentifier": "mycluster",
                    "ScheduleAssociationState": "ACTIVE"
                }
            ]
        }
    ]
}

Weitere Informationen finden Sie unter Automatisierte Snapshot-Zeitpläne im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So beschreiben Sie einen Speicher

Im folgenden Beispiel für describe-storage werden Details zum Backup-Speicher und zu den vorläufigen Speichergrößen für das Konto angezeigt.

aws redshift describe-storage

Ausgabe:

{
    "TotalBackupSizeInMegaBytes": 193149.0,
    "TotalProvisionedStorageInMegaBytes": 655360.0
}

Weitere Informationen finden Sie unter Verwalten der Snapshot-Speicherung im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So beschreiben Sie den Status von Anfragen zur Tabellenwiederherstellung aus einem Cluster-Snapshot

Im folgenden Beispiel für describe-table-restore-status werden Details zu Anfragen zur Tabellenwiederherstellung angezeigt, die für den angegebenen Cluster gestellt wurden.

aws redshift describe-table-restore-status /
    --cluster-identifier mycluster

Ausgabe:

{
    "TableRestoreStatusDetails": [
        {
            "TableRestoreRequestId": "z1116630-0e80-46f4-ba86-bd9670411ebd",
            "Status": "IN_PROGRESS",
            "RequestTime": "2019-12-27T18:22:12.257Z",
            "ClusterIdentifier": "mycluster",
            "SnapshotIdentifier": "mysnapshotid",
            "SourceDatabaseName": "dev",
            "SourceSchemaName": "public",
            "SourceTableName": "mytable",
            "TargetDatabaseName": "dev",
            "TargetSchemaName": "public",
            "NewTableName": "mytable-clone"
        }
    ]
}

Weitere Informationen zu diesen Konfigurationen finden Sie unter Wiederherstellen einer Tabelle aus einem Snapshot im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So beschreiben Sie Tags

Im folgenden Beispiel für describe-tags werden die Ressourcen angezeigt, die der angegebene Cluster den angegebenen Tag-Namen und Werten zugeordnet hat.

aws redshift describe-tags \
    --resource-name arn:aws:redshift:us-west-2:123456789012:cluster:mycluster \
    --tag-keys clustertagkey \
    --tag-values clustertagvalue

Ausgabe:

{
    "TaggedResources": [
                    {
            "Tag": {
                "Key": "clustertagkey",
                "Value": "clustertagvalue"
            },
            "ResourceName": "arn:aws:redshift:us-west-2:123456789012:cluster:mycluster",
            "ResourceType": "cluster"
        }
    ]
}

Weitere Informationen finden Sie unter Markieren von Ressourcen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So deaktivieren Sie Snapshot-Kopien für einen Cluster

Im folgenden Beispiel für disable-snapshot-copy wird das automatische Kopieren eines Snapshots für den angegebenen Cluster deaktiviert.

aws redshift disable-snapshot-copy \
    --cluster-identifier mycluster

Ausgabe:

{
    "Cluster": {
        "ClusterIdentifier": "mycluster",
        "NodeType": "dc2.large",
        "ClusterStatus": "available",
        "ClusterAvailabilityStatus": "Available",
        "MasterUsername": "adminuser",
        "DBName": "dev",
        "Endpoint": {
            "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
            "Port": 5439
        },
        "ClusterCreateTime": "2019-12-05T18:44:36.991Z",
        "AutomatedSnapshotRetentionPeriod": 3,
        "ManualSnapshotRetentionPeriod": -1,
        "ClusterSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sh-i9b431cd",
                "Status": "active"
            }
        ],
        "ClusterParameterGroups": [
            {
                "ParameterGroupName": "default.redshift-1.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "ClusterSubnetGroupName": "default",
        "VpcId": "vpc-b1fel7t9",
        "AvailabilityZone": "us-west-2f",
        "PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
        "PendingModifiedValues": {
            "NodeType": "dc2.large",
            "NumberOfNodes": 2,
            "ClusterType": "multi-node"
        },
        "ClusterVersion": "1.0",
        "AllowVersionUpgrade": true,
        "NumberOfNodes": 4,
        "PubliclyAccessible": false,
        "Encrypted": false,
        "Tags": [
            {
                "Key": "mytags",
                "Value": "tag1"
            }
        ],
        "EnhancedVpcRouting": false,
        "IamRoles": [
            {
                "IamRoleArn": "arn:aws:iam::123456789012:role/myRedshiftRole",
                "ApplyStatus": "in-sync"
            }
        ],
        "MaintenanceTrackName": "current",
        "DeferredMaintenanceWindows": [],
        "ExpectedNextSnapshotScheduleTime": "2019-12-10T04:42:43.390Z",
        "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack",
        "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z"
    }
}

Weitere Informationen finden Sie unter Snapshots in eine andere AWS-Region kopieren im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So aktivieren Sie das Kopieren von Snapshots für einen Cluster

Im folgenden Beispiel für enable-snapshot-copy wird das automatische Kopieren eines Snapshots für den angegebenen Cluster aktiviert.

aws redshift enable-snapshot-copy \
    --cluster-identifier mycluster \
    --destination-region us-west-1

Ausgabe:

{
    "Cluster": {
        "ClusterIdentifier": "mycluster",
        "NodeType": "dc2.large",
        "ClusterStatus": "available",
        "ClusterAvailabilityStatus": "Available",
        "MasterUsername": "adminuser",
        "DBName": "dev",
        "Endpoint": {
            "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
            "Port": 5439
        },
        "ClusterCreateTime": "2019-12-05T18:44:36.991Z",
        "AutomatedSnapshotRetentionPeriod": 3,
        "ManualSnapshotRetentionPeriod": -1,
        "ClusterSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sh-f4c731cd",
                "Status": "active"
            }
        ],
        "ClusterParameterGroups": [
            {
                "ParameterGroupName": "default.redshift-1.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "ClusterSubnetGroupName": "default",
        "VpcId": "vpc-b1ael7t9",
        "AvailabilityZone": "us-west-2f",
        "PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
        "PendingModifiedValues": {
            "NodeType": "dc2.large",
            "NumberOfNodes": 2,
            "ClusterType": "multi-node"
        },
        "ClusterVersion": "1.0",
        "AllowVersionUpgrade": true,
        "NumberOfNodes": 4,
        "PubliclyAccessible": false,
        "Encrypted": false,
        "ClusterSnapshotCopyStatus": {
            "DestinationRegion": "us-west-1",
            "RetentionPeriod": 7,
            "ManualSnapshotRetentionPeriod": -1
        },
        "Tags": [
            {
                "Key": "mytags",
                "Value": "tag1"
            }
        ],
        "EnhancedVpcRouting": false,
        "IamRoles": [
            {
                "IamRoleArn": "arn:aws:iam::123456789012:role/myRedshiftRole",
                "ApplyStatus": "in-sync"
            }
        ],
        "MaintenanceTrackName": "current",
        "DeferredMaintenanceWindows": [],
        "ExpectedNextSnapshotScheduleTime": "2019-12-10T04:42:43.390Z",
        "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack",
        "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z"
    }
}

Weitere Informationen finden Sie unter Snapshots in eine andere AWS-Region kopieren im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So rufen Sie Cluster-Anmeldeinformationen für ein AWS-Konto auf

Im folgenden Beispiel für get-cluster-credentials werden temporäre Anmeldeinformationen abgerufen, die den Zugriff auf eine Amazon-Redshift-Datenbank ermöglichen.

aws redshift get-cluster-credentials \
    --db-user adminuser --db-name dev \
    --cluster-identifier mycluster

Ausgabe:

{
    "DbUser": "IAM:adminuser",
    "DbPassword": "AMAFUyyuros/QjxPTtgzcsuQsqzIasdzJEN04aCtWDzXx1O9d6UmpkBtvEeqFly/EXAMPLE==",
    "Expiration": "2019-12-10T17:25:05.770Z"
}

Weitere Informationen finden Sie unter Erstellen von IAM-Datenbank-Anmeldeinformationen mithilfe der Amazon-Redshift-CLI oder -API im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So rufen Sie Angebote für den Austausch reservierter Knoten ab

Im folgenden Beispiel für get-reserved-node-exchange-offerings wird ein Array von DC2-ReservedNodeOfferings abgerufen, das dem angegebenen reservierten Knoten von DC1 entspricht.

aws redshift get-reserved-node-exchange-offerings \
    --reserved-node-id 12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE

Ausgabe:

{
    "ReservedNodeOfferings": [
        {
            "ReservedNodeOfferingId": "12345678-12ab-12a1-1a2a-12ab-12a12EXAMPLE",
            "NodeType": "dc2.large",
            "Duration": 31536000,
            "FixedPrice": 0.0,
            "UsagePrice": 0.0,
            "CurrencyCode": "USD",
            "OfferingType": "All Upfront",
            "RecurringCharges": [
                {
                    "RecurringChargeAmount": 0.0,
                    "RecurringChargeFrequency": "Hourly"
                }
            ],
            "ReservedNodeOfferingType": "Regular"
        }
    ]
}

Weitere Informationen finden Sie unter Upgrade von reservierten Knoten mit der AWS-CLI im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So ändern Sie die IAM-Rolle für einen Cluster

Im folgenden Beispiel für modify-cluster-iam-roles wird die angegebene AWS-IAM-Rolle aus dem angegebenen Cluster entfernt.

aws redshift modify-cluster-iam-roles \
    --cluster-identifier mycluster \
    --remove-iam-roles arn:aws:iam::123456789012:role/myRedshiftRole

Ausgabe:

{
    "Cluster": {
        "ClusterIdentifier": "mycluster",
        "NodeType": "dc2.large",
        "ClusterStatus": "available",
        "ClusterAvailabilityStatus": "Available",
        "MasterUsername": "adminuser",
        "DBName": "dev",
        "Endpoint": {
            "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
            "Port": 5439
        },
        "ClusterCreateTime": "2019-12-05T18:44:36.991Z",
        "AutomatedSnapshotRetentionPeriod": 3,
        "ManualSnapshotRetentionPeriod": -1,
        "ClusterSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sh-f9b731sd",
                "Status": "active"
            }
        ],
        "ClusterParameterGroups": [
            {
                "ParameterGroupName": "default.redshift-1.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "ClusterSubnetGroupName": "default",
        "VpcId": "vpc-b2fal7t9",
        "AvailabilityZone": "us-west-2f",
        "PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
        "PendingModifiedValues": {
            "NodeType": "dc2.large",
            "NumberOfNodes": 2,
            "ClusterType": "multi-node"
        },
        "ClusterVersion": "1.0",
        "AllowVersionUpgrade": true,
        "NumberOfNodes": 4,
        "PubliclyAccessible": false,
        "Encrypted": false,
        "ClusterSnapshotCopyStatus": {
            "DestinationRegion": "us-west-1",
            "RetentionPeriod": 7,
            "ManualSnapshotRetentionPeriod": -1
        },
        "Tags": [
            {
                "Key": "mytags",
                "Value": "tag1"
            }
        ],
        "EnhancedVpcRouting": false,
        "IamRoles": [],
        "MaintenanceTrackName": "current",
        "DeferredMaintenanceWindows": [],
        "ExpectedNextSnapshotScheduleTime": "2019-12-11T04:42:55.631Z",
        "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack",
        "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z"
    }
}

Weitere Informationen finden Sie unter Verwenden von identitätsbasierten Richtlinien (IAM-Richtlinien) für Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So ändern Sie die Clusterwartung

Im folgenden Beispiel für modify-cluster-maintenance wird die Wartung des angegebenen Clusters um 30 Tage verschoben.

aws redshift modify-cluster-maintenance \
    --cluster-identifier mycluster \
    --defer-maintenance \
    --defer-maintenance-duration 30

Ausgabe:

{
    "Cluster": {
        "ClusterIdentifier": "mycluster",
        "NodeType": "dc2.large",
        "ClusterStatus": "available",
        "ClusterAvailabilityStatus": "Available",
        "MasterUsername": "adminuser",
        "DBName": "dev",
        "Endpoint": {
            "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
            "Port": 5439
        },
        "ClusterCreateTime": "2019-12-05T18:44:36.991Z",
        "AutomatedSnapshotRetentionPeriod": 3,
        "ManualSnapshotRetentionPeriod": -1,
        "ClusterSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sh-a1a123ab",
                "Status": "active"
            }
        ],
        "ClusterParameterGroups": [
            {
                "ParameterGroupName": "default.redshift-1.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "ClusterSubnetGroupName": "default",
        "VpcId": "vpc-b1ael7t9",
        "AvailabilityZone": "us-west-2f",
        "PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
        "PendingModifiedValues": {
            "NodeType": "dc2.large",
            "NumberOfNodes": 2,
            "ClusterType": "multi-node"
        },
        "ClusterVersion": "1.0",
        "AllowVersionUpgrade": true,
        "NumberOfNodes": 4,
        "PubliclyAccessible": false,
        "Encrypted": false,
        "ClusterSnapshotCopyStatus": {
            "DestinationRegion": "us-west-1",
            "RetentionPeriod": 7,
            "ManualSnapshotRetentionPeriod": -1
        },
        "Tags": [
            {
                "Key": "mytags",
                "Value": "tag1"
            }
        ],
        "EnhancedVpcRouting": false,
        "IamRoles": [],
        "MaintenanceTrackName": "current",
        "DeferredMaintenanceWindows": [
            {
                "DeferMaintenanceIdentifier": "dfm-mUdVIfFcT1B4SGhw6fyF",
                "DeferMaintenanceStartTime": "2019-12-10T18:18:39.354Z",
                "DeferMaintenanceEndTime": "2020-01-09T18:18:39.354Z"
            }
        ],
        "ExpectedNextSnapshotScheduleTime": "2019-12-11T04:42:55.631Z",
        "ExpectedNextSnapshotScheduleTimeStatus": "OnTrack",
        "NextMaintenanceWindowStartTime": "2020-01-11T16:00:00Z"
    }
}

Weitere Informationen finden Sie unter Cluster-Verwaltung im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So ändern Sie Parameter in einer Parametergruppe

Im folgenden Beispiel modify-cluster-parameter-group wird der wlm_json_configuration-Parameter für die Workload-Verwaltung geändert. Es werden die Parameter aus einer Datei akzeptiert, die den unten gezeigten JSON-Inhalt enthält.

aws redshift modify-cluster-parameter-group \
    --parameter-group-name myclusterparametergroup \
    --parameters file://modify_pg.json

Inhalt von modify_pg.json:

[
    {
        "ParameterName": "wlm_json_configuration",
        "ParameterValue": "[{\"user_group\":\"example_user_group1\",\"query_group\": \"example_query_group1\", \"query_concurrency\":7},{\"query_concurrency\":5}]"
    }
]

Ausgabe:

{
   "ParameterGroupStatus": "Your parameter group has been updated but changes won't get applied until you reboot the associated Clusters.",
   "ParameterGroupName": "myclusterparametergroup",
   "ResponseMetadata": {
      "RequestId": "09974cc0-64cd-11e2-bea9-49e0ce183f07"
   }
}

So ändern Sie den Cluster-Snapshot-Zeitplan

Im folgenden Beispiel für modify-cluster-snapshot-schedule wird der angegebene Snapshot-Zeitplan aus dem angegebenen Cluster entfernt.

aws redshift modify-cluster-snapshot-schedule \
    --cluster-identifier mycluster \
    --schedule-identifier mysnapshotschedule \
    --disassociate-schedule

Dieser Befehl erzeugt keine Ausgabe.

Weitere Informationen finden Sie unter Zeitpläne für automatisierte Snapshots im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So ändern Sie den Cluster-Snapshot

Im folgenden Beispiel für modify-cluster-snapshot wird die Einstellung für den manuellen Aufbewahrungszeitraum für den angegebenen Cluster-Snapshot auf den Wert von 10 Tagen festgelegt.

aws redshift modify-cluster-snapshot \
    --snapshot-identifier mycluster-2019-11-06-16-32 \
    --manual-snapshot-retention-period 10

Ausgabe:

{
    "Snapshot": {
        "SnapshotIdentifier": "mycluster-2019-11-06-16-32",
        "ClusterIdentifier": "mycluster",
        "SnapshotCreateTime": "2019-12-07T00:34:05.633Z",
        "Status": "available",
        "Port": 5439,
        "AvailabilityZone": "us-west-2f",
        "ClusterCreateTime": "2019-12-05T18:44:36.991Z",
        "MasterUsername": "adminuser",
        "ClusterVersion": "1.0",
        "SnapshotType": "manual",
        "NodeType": "dc2.large",
        "NumberOfNodes": 2,
        "DBName": "dev",
        "VpcId": "vpc-b1cel7t9",
        "Encrypted": false,
        "EncryptedWithHSM": false,
        "OwnerAccount": "123456789012",
        "TotalBackupSizeInMegaBytes": 64384.0,
        "ActualIncrementalBackupSizeInMegaBytes": 24.0,
        "BackupProgressInMegaBytes": 24.0,
        "CurrentBackupRateInMegaBytesPerSecond": 13.0011,
        "EstimatedSecondsToCompletion": 0,
        "ElapsedTimeInSeconds": 1,
        "Tags": [
            {
                "Key": "mytagkey",
                "Value": "mytagvalue"
            }
        ],
        "EnhancedVpcRouting": false,
        "MaintenanceTrackName": "current",
        "ManualSnapshotRetentionPeriod": 10,
        "ManualSnapshotRemainingDays": 6,
        "SnapshotRetentionStartTime": "2019-12-07T00:34:07.479Z"
    }
}

Weitere Informationen finden Sie unter Amazon-Redshift-Snapshots im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Ändern der Subnetze in einer Cluster-Subnetzgruppe Dieses Beispiel zeigt, wie die Liste der Subnetze in einer Cache-Subnetzgruppe geändert wird. JSON ist das Standardausgabeformat. Befehl:

aws redshift modify-cluster-subnet-group --cluster-subnet-group-name mysubnetgroup --subnet-ids subnet-763fdd1 subnet-ac830e9

Ergebnis:

{
   "ClusterSubnetGroup":
   {
      "Subnets": [
         {
            "SubnetStatus": "Active",
            "SubnetIdentifier": "subnet-763fdd1c",
            "SubnetAvailabilityZone":
               { "Name": "us-east-1a" }
         },
         {
            "SubnetStatus": "Active",
            "SubnetIdentifier": "subnet-ac830e9",
            "SubnetAvailabilityZone":
               { "Name": "us-east-1b" }
         } ],
      "VpcId": "vpc-7e3fdd14",
      "SubnetGroupStatus": "Complete",
      "Description": "My subnet group",
      "ClusterSubnetGroupName": "mysubnetgroup"
   },
   "ResponseMetadata": {
      "RequestId": "8da93e89-8372-f936-93a8-873918938197a"
   }
}

Zuordnen einer Sicherheitsgruppe zu einem Cluster Dieses Beispiel zeigt, wie eine Cluster-Sicherheitsgruppe dem angegebenen Cluster zugeordnet wird. Befehl:

aws redshift modify-cluster --cluster-identifier mycluster --cluster-security-groups mysecuritygroup

Das Wartungsfenster für einen Cluster ändern Hier wird gezeigt, wie Sie das bevorzugte wöchentliche Wartungsfenster für einen Cluster so ändern können, dass es mindestens vier Stunden dauert und sonntags um 23:15 Uhr beginnt und montags um 3:15 Uhr endet. Befehl:

aws redshift modify-cluster --cluster-identifier mycluster --preferred-maintenance-window Sun:23:15-Mon:03:15

Das Master-Passwort für den Cluster ändern Dieses Beispiel zeigt, wie das Master-Passwort für einen Cluster geändert wird. Befehl:

aws redshift modify-cluster --cluster-identifier mycluster --master-user-password A1b2c3d4

So ändern Sie ein Ereignisabonnement

Im folgenden Beispiel für modify-event-subscription wird das angegebene Abonnement für Ereignisbenachrichtigungen deaktiviert.

aws redshift modify-event-subscription \
    --subscription-name mysubscription \
    --no-enabled

Ausgabe:

{
    "EventSubscription": {
        "CustomerAwsId": "123456789012",
        "CustSubscriptionId": "mysubscription",
        "SnsTopicArn": "arn:aws:sns:us-west-2:123456789012:MySNStopic",
        "Status": "active",
        "SubscriptionCreationTime": "2019-12-09T21:50:21.332Z",
        "SourceIdsList": [],
        "EventCategoriesList": [
            "management"
        ],
        "Severity": "ERROR",
        "Enabled": false,
        "Tags": []
    }
}

Weitere Informationen finden Sie unter Abonnieren von Ereignisbenachrichtigungen in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So ändern Sie eine geplante Aktion

Im folgenden Beispiel für modify-scheduled-action wird der angegebenen vorhandenen geplanten Aktion eine Beschreibung hinzugefügt.

aws redshift modify-scheduled-action \
    --scheduled-action-name myscheduledaction \
    --scheduled-action-description "My scheduled action"

Ausgabe:

{
    "ScheduledActionName": "myscheduledaction",
    "TargetAction": {
        "ResizeCluster": {
            "ClusterIdentifier": "mycluster",
            "NumberOfNodes": 2,
            "Classic": false
        }
    },
    "Schedule": "at(2019-12-25T00:00:00)",
    "IamRole": "arn:aws:iam::123456789012:role/myRedshiftRole",
    "ScheduledActionDescription": "My scheduled action",
    "State": "ACTIVE",
    "NextInvocations": [
        "2019-12-25T00:00:00Z"
    ]
}

So ändern Sie den Aufbewahrungszeitraums für Snapshot-Kopien

Im folgenden Beispiel für modify-snapshot-copy-retention-period wird die Anzahl der Tage, die Snapshots für den angegebenen Cluster in der Zielregion AWS aufbewahrt werden sollen, nachdem sie aus der Quellregion AWS kopiert wurden.

aws redshift modify-snapshot-copy-retention-period \
    --cluster-identifier mycluster \
    --retention-period 15

Ausgabe:

{
    "Cluster": {
        "ClusterIdentifier": "mycluster",
        "NodeType": "dc2.large",
        "ClusterStatus": "available",
        "ClusterAvailabilityStatus": "Available",
        "MasterUsername": "adminuser",
        "DBName": "dev",
        "Endpoint": {
            "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
            "Port": 5439
        },
        "ClusterCreateTime": "2019-12-05T18:44:36.991Z",
        "AutomatedSnapshotRetentionPeriod": 3,
        "ManualSnapshotRetentionPeriod": -1,
        "ClusterSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sh-a1a123ab",
                "Status": "active"
            }
        ],
        "ClusterParameterGroups": [
            {
                "ParameterGroupName": "default.redshift-1.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "ClusterSubnetGroupName": "default",
        "VpcId": "vpc-b1fet7t9",
        "AvailabilityZone": "us-west-2f",
        "PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
        "PendingModifiedValues": {
            "NodeType": "dc2.large",
            "NumberOfNodes": 2,
            "ClusterType": "multi-node"
        },
        "ClusterVersion": "1.0",
        "AllowVersionUpgrade": true,
        "NumberOfNodes": 4,
        "PubliclyAccessible": false,
        "Encrypted": false,
        "ClusterSnapshotCopyStatus": {
            "DestinationRegion": "us-west-1",
            "RetentionPeriod": 15,
            "ManualSnapshotRetentionPeriod": -1
        },
        "Tags": [
            {
                "Key": "mytags",
                "Value": "tag1"
            }
        ],
        "EnhancedVpcRouting": false,
        "IamRoles": [],
        "MaintenanceTrackName": "current",
        "DeferredMaintenanceWindows": [
            {
                "DeferMaintenanceIdentifier": "dfm-mUdVSfDcT1F4SGhw6fyF",
                "DeferMaintenanceStartTime": "2019-12-10T18:18:39.354Z",
                "DeferMaintenanceEndTime": "2020-01-09T18:18:39.354Z"
            }
        ],
        "NextMaintenanceWindowStartTime": "2020-01-11T16:00:00Z"
    }
}

Weitere Informationen finden Sie unter Format von Snapshot-Zeitplänen im Amazon-Redshift-Cluster-Verwaltungshandbuch.

So ändern Sie den Snapshot-Zeitplan

Im folgenden Beispiel für modify-snapshot-schedule wird die Rate des angegebenen Snapshot-Zeitplans auf alle 10 Stunden geändert.

aws redshift modify-snapshot-schedule \
    --schedule-identifier mysnapshotschedule \
    --schedule-definitions "rate(10 hours)"

Ausgabe:

{
    "ScheduleDefinitions": [
        "rate(10 hours)"
    ],
    "ScheduleIdentifier": "mysnapshotschedule",
    "ScheduleDescription": "My schedule description",
    "Tags": []
}

Weitere Informationen finden Sie unter Format von Snapshot-Zeitplänen im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Einen reservierten Knoten kaufenIn diesem Beispiel wird gezeigt, wie Sie ein Angebot für reservierte Knoten erwerben. reserved-node-offering-id wird durch Aufrufen von describe-reserved-node-offerings erhalten. Befehl:

aws redshift purchase-reserved-node-offering --reserved-node-offering-id ceb6a579-cf4c-4343-be8b-d832c45ab51c

Ergebnis:

{
   "ReservedNode": {
      "OfferingType": "Heavy Utilization",
      "FixedPrice": "",
      "NodeType": "dw.hs1.xlarge",
      "ReservedNodeId": "1ba8e2e3-bc01-4d65-b35d-a4a3e931547e",
      "UsagePrice": "",
      "RecurringCharges": [
         {
            "RecurringChargeAmount": "",
            "RecurringChargeFrequency": "Hourly"
         }
      ],
      "NodeCount": 1,
      "State": "payment-pending",
      "StartTime": "2013-02-13T17:08:39.051Z",
      "Duration": 31536000,
      "ReservedNodeOfferingId": "ceb6a579-cf4c-4343-be8b-d832c45ab51c"
   },
   "ResponseMetadata": {
      "RequestId": "01bda7bf-7600-11e2-b605-2568d7396e7f"
   }
}

Einen Cluster neu startenIn diesem Beispiel wird ein Cluster neu gestartet. JSON ist das Standardausgabeformat. Befehl:

aws redshift reboot-cluster --cluster-identifier mycluster

Ergebnis:

{
   "Cluster": {
      "NodeType": "dw.hs1.xlarge",
      "Endpoint": {
         "Port": 5439,
         "Address": "mycluster.coqoarplqhsn.us-east-1.redshift.amazonaws.com"
      },
      "ClusterVersion": "1.0",
      "PubliclyAccessible": "true",
      "MasterUsername": "adminuser",
      "ClusterParameterGroups": [
         {
         "ParameterApplyStatus": "in-sync",
         "ParameterGroupName": "default.redshift-1.0"
         }
      ],
      "ClusterSecurityGroups": [
         {
         "Status": "active",
         "ClusterSecurityGroupName": "default"
         }
      ],
      "AllowVersionUpgrade": true,
      "VpcSecurityGroups": \[],
      "AvailabilityZone": "us-east-1a",
      "ClusterCreateTime": "2013-01-22T21:59:29.559Z",
      "PreferredMaintenanceWindow": "sun:23:15-mon:03:15",
      "AutomatedSnapshotRetentionPeriod": 1,
      "ClusterStatus": "rebooting",
      "ClusterIdentifier": "mycluster",
      "DBName": "dev",
      "NumberOfNodes": 2,
      "PendingModifiedValues": {}
   },
   "ResponseMetadata": {
      "RequestId": "61c8b564-64e8-11e2-8f7d-3b939af52818"
   }
}

Parameter in einer Parametergruppe zurücksetzen Dieses Beispiel zeigt, wie alle Parameter in einer Parametergruppe zurückgesetzt werden. Befehl:

aws redshift reset-cluster-parameter-group --parameter-group-name myclusterparametergroup --reset-all-parameters

So passen Sie die Größe eines Clusters

Im folgenden Beispiel für resize-cluster wird die Größe des angegebenen Clusters geändert.

aws redshift resize-cluster \
    --cluster-identifier mycluster \
    --cluster-type multi-node \
    --node-type dc2.large \
    --number-of-nodes 6 \
    --classic

Ausgabe:

{
    "Cluster": {
        "ClusterIdentifier": "mycluster",
        "NodeType": "dc2.large",
        "ClusterStatus": "resizing",
        "ClusterAvailabilityStatus": "Modifying",
        "MasterUsername": "adminuser",
        "DBName": "dev",
        "Endpoint": {
            "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
            "Port": 5439
        },
        "ClusterCreateTime": "2019-12-05T18:44:36.991Z",
        "AutomatedSnapshotRetentionPeriod": 3,
        "ManualSnapshotRetentionPeriod": -1,
        "ClusterSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sh-a1a123ab",
                "Status": "active"
            }
        ],
        "ClusterParameterGroups": [
            {
                "ParameterGroupName": "default.redshift-1.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "ClusterSubnetGroupName": "default",
        "VpcId": "vpc-a1abc1a1",
        "AvailabilityZone": "us-west-2f",
        "PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
        "PendingModifiedValues": {
            "NodeType": "dc2.large",
            "NumberOfNodes": 6,
            "ClusterType": "multi-node"
        },
        "ClusterVersion": "1.0",
        "AllowVersionUpgrade": true,
        "NumberOfNodes": 4,
        "PubliclyAccessible": false,
        "Encrypted": false,
        "ClusterSnapshotCopyStatus": {
            "DestinationRegion": "us-west-1",
            "RetentionPeriod": 15,
            "ManualSnapshotRetentionPeriod": -1
        },
        "Tags": [
            {
                "Key": "mytags",
                "Value": "tag1"
            }
        ],
        "EnhancedVpcRouting": false,
        "IamRoles": [],
        "MaintenanceTrackName": "current",
        "DeferredMaintenanceWindows": [
            {
                "DeferMaintenanceIdentifier": "dfm-mUdVCfDcT1B4SGhw6fyF",
                "DeferMaintenanceStartTime": "2019-12-10T18:18:39.354Z",
                "DeferMaintenanceEndTime": "2020-01-09T18:18:39.354Z"
            }
        ],
        "NextMaintenanceWindowStartTime": "2020-01-11T16:00:00Z",
        "ResizeInfo": {
            "ResizeType": "ClassicResize",
            "AllowCancelResize": true
        }
    }
}

Weitere Informationen finden Sie unter Größenanpassung eines Clusters im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Einen Cluster aus einem Snapshot wiederherstellenIn diesem Beispiel wird ein Cluster aus einem Snapshot wiederhergestellt. Befehl:

aws redshift restore-from-cluster-snapshot --cluster-identifier mycluster-clone --snapshot-identifier my-snapshot-id

Ergebnis:

{
   "Cluster": {
      "NodeType": "dw.hs1.xlarge",
      "ClusterVersion": "1.0",
      "PubliclyAccessible": "true",
      "MasterUsername": "adminuser",
      "ClusterParameterGroups": [
         {
         "ParameterApplyStatus": "in-sync",
         "ParameterGroupName": "default.redshift-1.0"
         }
      ],
      "ClusterSecurityGroups": [
         {
         "Status": "active",
         "ClusterSecurityGroupName": "default"
         }
      ],
      "AllowVersionUpgrade": true,
      "VpcSecurityGroups": \[],
      "PreferredMaintenanceWindow": "sun:23:15-mon:03:15",
      "AutomatedSnapshotRetentionPeriod": 1,
      "ClusterStatus": "creating",
      "ClusterIdentifier": "mycluster-clone",
      "DBName": "dev",
      "NumberOfNodes": 2,
      "PendingModifiedValues": {}
   },
   "ResponseMetadata": {
      "RequestId": "77fd512b-64e3-11e2-8f5b-e90bd6c77476"
   }
}

So stellen Sie einen Cluster mithilfe eines Snapshots wieder her

Im folgenden Beispiel für restore-table-from-cluster-snapshot wird aus der angegebenen Tabelle im angegebenen Cluster-Snapshot eine neue Tabelle erstellt.

aws redshift restore-table-from-cluster-snapshot /
    --cluster-identifier mycluster /
    --snapshot-identifier mycluster-2019-11-19-16-17 /
    --source-database-name dev /
    --source-schema-name public /
    --source-table-name mytable /
    --target-database-name dev /
    --target-schema-name public /
    --new-table-name mytable-clone

Ausgabe:

{
    "TableRestoreStatus": {
        "TableRestoreRequestId": "a123a12b-abc1-1a1a-a123-a1234ab12345",
        "Status": "PENDING",
        "RequestTime": "2019-12-20T00:20:16.402Z",
        "ClusterIdentifier": "mycluster",
        "SnapshotIdentifier": "mycluster-2019-11-19-16-17",
        "SourceDatabaseName": "dev",
        "SourceSchemaName": "public",
        "SourceTableName": "mytable",
        "TargetDatabaseName": "dev",
        "TargetSchemaName": "public",
        "NewTableName": "mytable-clone"
    }
}

Weitere Informationen zu diesen Konfigurationen finden Sie unter Wiederherstellen einer Tabelle aus einem Snapshot im Amazon-Redshift-Cluster-Verwaltungshandbuch.

Zugriff von einer EC2-Sicherheitsgruppe widerrufenIn diesem Beispiel wird der Zugriff auf eine benannte Amazon EC2-Sicherheitsgruppe widerrufen. Befehl:

aws redshift revoke-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --ec2-security-group-name myec2securitygroup --ec2-security-group-owner-id 123445677890

Zugriff auf einen CIDR-Bereich widerrufenIn diesem Beispiel wird der Zugriff auf einen CIDR-Bereich widerrufen. Befehl:

aws redshift revoke-cluster-security-group-ingress --cluster-security-group-name mysecuritygroup --cidrip 192.168.100.100/32

Widerrufen der Autorisierung eines AWS-Kontos zur Wiederherstellung eines SnapshotsIn diesem Beispiel wird die Autorisierung des AWS-Kontos 444455556666 zur Wiederherstellung des Snapshots my-snapshot-id widerrufen. JSON ist das Standardausgabeformat. Befehl:

aws redshift revoke-snapshot-access --snapshot-id my-snapshot-id --account-with-restore-access 444455556666

Ergebnis:

{
   "Snapshot": {
      "Status": "available",
      "SnapshotCreateTime": "2013-07-17T22:04:18.947Z",
      "EstimatedSecondsToCompletion": 0,
      "AvailabilityZone": "us-east-1a",
      "ClusterVersion": "1.0",
      "MasterUsername": "adminuser",
      "Encrypted": false,
      "OwnerAccount": "111122223333",
      "BackupProgressInMegabytes": 11.0,
      "ElapsedTimeInSeconds": 0,
      "DBName": "dev",
      "CurrentBackupRateInMegabytesPerSecond: 0.1534,
      "ClusterCreateTime": "2013-01-22T21:59:29.559Z",
      "ActualIncrementalBackupSizeInMegabytes"; 11.0,
      "SnapshotType": "manual",
      "NodeType": "dw.hs1.xlarge",
      "ClusterIdentifier": "mycluster",
      "TotalBackupSizeInMegabytes": 20.0,
      "Port": 5439,
      "NumberOfNodes": 2,
      "SnapshotIdentifier": "my-snapshot-id"
   }
}

So rotieren Sie die Verschlüsselungscodes für einen Cluster

Im folgenden Beispiel für rotate-encryption-key wird der Verschlüsselungsschlüssel für den angegebenen Cluster rotiert.

aws redshift rotate-encryption-key \
    --cluster-identifier mycluster

Ausgabe:

{
    "Cluster": {
        "ClusterIdentifier": "mycluster",
        "NodeType": "dc2.large",
        "ClusterStatus": "rotating-keys",
        "ClusterAvailabilityStatus": "Modifying",
        "MasterUsername": "adminuser",
        "DBName": "dev",
        "Endpoint": {
            "Address": "mycluster.cmeaswqeuae.us-west-2.redshift.amazonaws.com",
            "Port": 5439
        },
        "ClusterCreateTime": "2019-12-10T19:25:45.886Z",
        "AutomatedSnapshotRetentionPeriod": 30,
        "ManualSnapshotRetentionPeriod": -1,
        "ClusterSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sh-a1a123ab",
                "Status": "active"
            }
        ],
        "ClusterParameterGroups": [
            {
                "ParameterGroupName": "default.redshift-1.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "ClusterSubnetGroupName": "default",
        "VpcId": "vpc-a1abc1a1",
        "AvailabilityZone": "us-west-2a",
        "PreferredMaintenanceWindow": "sat:16:00-sat:16:30",
        "PendingModifiedValues": {},
        "ClusterVersion": "1.0",
        "AllowVersionUpgrade": true,
        "NumberOfNodes": 2,
        "PubliclyAccessible": false,
        "Encrypted": true,
        "Tags": [],
        "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/bPxRfih3yCo8nvbEXAMPLEKEY",
        "EnhancedVpcRouting": false,
        "IamRoles": [
            {
                "IamRoleArn": "arn:aws:iam::123456789012:role/myRedshiftRole",
                "ApplyStatus": "in-sync"
            }
        ],
        "MaintenanceTrackName": "current",
        "DeferredMaintenanceWindows": [],
        "NextMaintenanceWindowStartTime": "2019-12-14T16:00:00Z"
    }
}

Weitere Informationen finden Sie unter Datenbankverschlüsselung in Amazon Redshift im Amazon-Redshift-Cluster-Verwaltungshandbuch.