Beispiele für Amazon Redshift - AWS SDK for JavaScript
Erforderliche AufgabenEinen Amazon Redshift Redshift-Cluster erstellenÄndern eines Amazon Redshift Redshift-ClustersDetails eines Amazon Redshift Redshift-Clusters anzeigenLöschen Sie einen Amazon Redshift Redshift-Cluster

Das AWS SDK for JavaScript APIV3-Referenzhandbuch beschreibt detailliert alle API Operationen für die AWS SDK for JavaScript Version 3 (V3).

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Beispiele für Amazon Redshift

In diesem Beispiel werden eine Reihe von Node.js -Modulen verwendet, um Amazon Redshift Redshift-Cluster mit den folgenden Methoden der Redshift Client-Klasse zu erstellen, zu ändern, zu beschreiben und anschließend zu löschen:

Weitere Informationen zu Amazon Redshift-Benutzern finden Sie im Amazon Redshift Getting Started Guide.

Erforderliche Aufgaben

Zum Einrichten und Ausführen dieses Beispiels müssen Sie zunächst diese Aufgaben abschließen:

  • Richten Sie die Projektumgebung ein, um diese TypeScript Node-Beispiele auszuführen, und installieren Sie die erforderlichen Module AWS SDK for JavaScript und Module von Drittanbietern. Folgen Sie den Anweisungen auf GitHub.

  • Erstellen Sie eine freigegebene Konfigurationsdatei mit Ihren Anmeldeinformationen. Weitere Informationen zur Bereitstellung einer Datei mit gemeinsam genutzten Anmeldeinformationen finden Sie unter Dateien mit gemeinsam genutzten Konfigurationen und Anmeldeinformationen im AWS SDKsReferenzhandbuch zu Tools.

Wichtig

Diese Beispiele zeigen, wie Client-Dienstobjekte und Befehle mithilfe von ECMAScript6 () ES6 importiert/exportiert werden.

  • Dazu ist die Version 13.x von Node.js oder höher erforderlich. Informationen zum Herunterladen und Installieren der neuesten Version von Node.js finden Sie unter Node.js downloads. .

  • Wenn Sie die CommonJS-Syntax bevorzugen, finden Sie unter JavaScript ES6/CommonJS-Syntax

Einen Amazon Redshift Redshift-Cluster erstellen

Dieses Beispiel zeigt, wie Sie mit dem einen Amazon Redshift Redshift-Cluster erstellen. AWS SDK for JavaScript Weitere Informationen finden Sie unter CreateCluster.

Wichtig

Der Cluster, den Sie erstellen möchten, ist aktiv (und läuft nicht in einer Sandbox). Es fallen so lange die standardmäßigen Amazon-Redshift-Nutzungsgebühren für den Cluster an, bis Sie ihn löschen. Wenn Sie den Cluster in derselben Sitzung löschen, in der Sie ihn erstellt haben, sind die Gesamtkosten minimal.

Erstellen Sie ein libs Verzeichnis und ein Modul Node.js mit dem DateinamenredshiftClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon Redshift Redshift-Client-Objekt erstellt wird. Ersetzen REGION mit Ihrer AWS Region.

import  { RedshiftClient }  from  "@aws-sdk/client-redshift";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create Redshift service object.
const redshiftClient = new RedshiftClient({ region: REGION });
export { redshiftClient };

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen redshift-create-cluster.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich der Installation der erforderlichen Clients und Pakete. Erstellen Sie ein Parameterobjekt, das den Knotentyp, der bereitgestellt werden soll, und die Master-Anmeldedaten für die Datenbank-Instance, die automatisch im Cluster erstellt wird, und schließlich den Clustertyp angibt.

Anmerkung

Ersetzen CLUSTER_NAME mit dem Namen des Clusters. Wählen Sie in der &Snowconsole; Ihren Auftrag aus der Tabelle. NODE_TYPE geben Sie den Knotentyp an, der bereitgestellt werden soll, z. B. 'dc2.large'. MASTER_USERNAME and MASTER_USER_PASSWORD sind die Anmeldedaten des Masterbenutzers Ihrer DB-Instance im Cluster. Wählen Sie in der &Snowconsole; Ihren Auftrag aus der Tabelle. CLUSTER_TYPE, geben Sie den Clustertyp ein. Wenn Sie angebensingle-node, benötigen Sie den NumberOfNodes Parameter nicht. Die übrigen Parameter sind optional. 

// Import required AWS SDK clients and commands for Node.js
import { CreateClusterCommand } from "@aws-sdk/client-redshift";
import { redshiftClient } from "./libs/redshiftClient.js";

const params = {
  ClusterIdentifier: "CLUSTER_NAME", // Required
  NodeType: "NODE_TYPE", //Required
  MasterUsername: "MASTER_USER_NAME", // Required - must be lowercase
  MasterUserPassword: "MASTER_USER_PASSWORD", // Required - must contain at least one uppercase letter, and one number
  ClusterType: "CLUSTER_TYPE", // Required
  IAMRoleARN: "IAM_ROLE_ARN", // Optional - the ARN of an IAM role with permissions your cluster needs to access other AWS services on your behalf, such as Amazon S3.
  ClusterSubnetGroupName: "CLUSTER_SUBNET_GROUPNAME", //Optional - the name of a cluster subnet group to be associated with this cluster. Defaults to 'default' if not specified.
  DBName: "DATABASE_NAME", // Optional - defaults to 'dev' if not specified
  Port: "PORT_NUMBER", // Optional - defaults to '5439' if not specified
};

const run = async () => {
  try {
    const data = await redshiftClient.send(new CreateClusterCommand(params));
    console.log(
      `Cluster ${data.Cluster.ClusterIdentifier} successfully created`,
    );
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

Um das Beispiel auszuführen, geben Sie an der Befehlszeile Folgendes ein.

node redshift-create-cluster.js

Diesen Beispielcode finden Sie hier auf GitHub.

Ändern eines Amazon Redshift Redshift-Clusters

Dieses Beispiel zeigt, wie Sie das Master-Benutzerkennwort eines Amazon Redshift Redshift-Clusters mithilfe von ändern. AWS SDK for JavaScript Weitere Informationen darüber, welche anderen Einstellungen Sie ändern können, finden Sie unter ModifyCluster.

Erstellen Sie ein libs Verzeichnis und ein Modul Node.js mit dem DateinamenredshiftClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon Redshift Redshift-Client-Objekt erstellt wird. Ersetzen REGION mit Ihrer AWS Region.

import  { RedshiftClient }  from  "@aws-sdk/client-redshift";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create Redshift service object.
const redshiftClient = new RedshiftClient({ region: REGION });
export { redshiftClient };

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen redshift-modify-cluster.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich der Installation der erforderlichen Clients und Pakete. Geben Sie die AWS Region, den Namen des Clusters, den Sie ändern möchten, und das neue Masterbenutzerkennwort an.

Anmerkung

Ersetzen CLUSTER_NAME mit dem Namen des Clusters und MASTER_USER_PASSWORD mit dem neuen Masterbenutzer-Passwort. 

// Import required AWS SDK clients and commands for Node.js
import { ModifyClusterCommand } from "@aws-sdk/client-redshift";
import { redshiftClient } from "./libs/redshiftClient.js";

// Set the parameters
const params = {
  ClusterIdentifier: "CLUSTER_NAME",
  MasterUserPassword: "NEW_MASTER_USER_PASSWORD",
};

const run = async () => {
  try {
    const data = await redshiftClient.send(new ModifyClusterCommand(params));
    console.log("Success was modified.", data);
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

Um das Beispiel auszuführen, geben Sie an der Befehlszeile Folgendes ein.

node redshift-modify-cluster.js

Diesen Beispielcode finden Sie hier auf GitHub.

Details eines Amazon Redshift Redshift-Clusters anzeigen

Dieses Beispiel zeigt, wie Sie die Details eines Amazon Redshift Redshift-Clusters mithilfe von anzeigen. AWS SDK for JavaScript Weitere Informationen zu optionalen Optionen finden Sie unter DescribeClusters.

Erstellen Sie ein libs Verzeichnis und ein Modul Node.js mit dem DateinamenredshiftClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon Redshift Redshift-Client-Objekt erstellt wird. Ersetzen REGION mit Ihrer AWS Region.

import  { RedshiftClient }  from  "@aws-sdk/client-redshift";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create Redshift service object.
const redshiftClient = new RedshiftClient({ region: REGION });
export { redshiftClient };

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Node.js-Modul mit dem Dateinamen redshift-describe-clusters.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich der Installation der erforderlichen Clients und Pakete. Geben Sie die AWS Region, den Namen des Clusters, den Sie ändern möchten, und das neue Masterbenutzerkennwort an.

Anmerkung

Ersetzen CLUSTER_NAME mit dem Namen des Clusters. 

// Import required AWS SDK clients and commands for Node.js
import { DescribeClustersCommand } from "@aws-sdk/client-redshift";
import { redshiftClient } from "./libs/redshiftClient.js";

const params = {
  ClusterIdentifier: "CLUSTER_NAME",
};

const run = async () => {
  try {
    const data = await redshiftClient.send(new DescribeClustersCommand(params));
    console.log("Success", data);
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

Um das Beispiel auszuführen, geben Sie an der Befehlszeile Folgendes ein.

node redshift-describe-clusters.js

Diesen Beispielcode finden Sie hier auf GitHub.

Löschen Sie einen Amazon Redshift Redshift-Cluster

Dieses Beispiel zeigt, wie Sie die Details eines Amazon Redshift Redshift-Clusters mithilfe von anzeigen. AWS SDK for JavaScript Weitere Informationen darüber, welche anderen Einstellungen Sie ändern können, finden Sie unter DeleteCluster.

Erstellen Sie ein libs Verzeichnis und ein Modul Node.js mit dem DateinamenredshiftClient.js. Kopieren Sie den folgenden Code und fügen Sie ihn ein, wodurch das Amazon Redshift Redshift-Client-Objekt erstellt wird. Ersetzen REGION mit Ihrer AWS Region.

import  { RedshiftClient }  from  "@aws-sdk/client-redshift";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create Redshift service object.
const redshiftClient = new RedshiftClient({ region: REGION });
export { redshiftClient };

Diesen Beispielcode finden Sie hier auf GitHub.

Erstellen Sie ein Modul Node.js mit dem Namen der Dateiredshift-delete-clusters.js. Stellen Sie sicher, dass Sie das SDK wie zuvor gezeigt konfigurieren, einschließlich der Installation der erforderlichen Clients und Pakete. Geben Sie die AWS Region, den Namen des Clusters, den Sie ändern möchten, und das neue Masterbenutzerkennwort an. Geben Sie dann an, ob Sie vor dem Löschen einen endgültigen Snapshot des Clusters speichern möchten, und wenn ja, die ID des Snapshots.

Anmerkung

Ersetzen CLUSTER_NAME mit dem Namen des Clusters. Für den SkipFinalClusterSnapshot, geben Sie an, ob vor dem Löschen ein letzter Snapshot des Clusters erstellt werden soll. Wenn Sie 'false' angeben, geben Sie die ID des endgültigen Cluster-Snapshots in CLUSTER_SNAPSHOT_ID. Sie können diese ID abrufen, indem Sie im Cluster-Dashboard auf den Link in der Spalte Snapshots für den Cluster klicken und nach unten zum Bereich Snapshots scrollen. Beachten Sie, dass der Stamm nicht Teil der Snapshot-ID rs: ist.

// Import required AWS SDK clients and commands for Node.js
import { DeleteClusterCommand } from "@aws-sdk/client-redshift";
import { redshiftClient } from "./libs/redshiftClient.js";

const params = {
  ClusterIdentifier: "CLUSTER_NAME",
  SkipFinalClusterSnapshot: false,
  FinalClusterSnapshotIdentifier: "CLUSTER_SNAPSHOT_ID",
};

const run = async () => {
  try {
    const data = await redshiftClient.send(new DeleteClusterCommand(params));
    console.log("Success, cluster deleted. ", data);
    return data; // For unit tests.
  } catch (err) {
    console.log("Error", err);
  }
};
run();

Um das Beispiel auszuführen, geben Sie in der Befehlszeile Folgendes ein.

node redshift-delete-cluster.js

Diesen Beispielcode finden Sie hier auf GitHub.