Esempi di Amazon Redshift - AWS SDK for JavaScript
Attività prerequisiteCreazione di un cluster Amazon RedshiftModifica di un cluster Amazon RedshiftVisualizzazione dei dettagli di un cluster Amazon RedshiftEliminare un cluster Amazon Redshift

La guida API di riferimento AWS SDK for JavaScript V3 descrive in dettaglio tutte le API operazioni per la AWS SDK for JavaScript versione 3 (V3).

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esempi di Amazon Redshift

In questo esempio, una serie di moduli Node.js vengono utilizzati per creare, modificare, descrivere i parametri e quindi eliminare i cluster Amazon Redshift utilizzando i seguenti metodi della Redshift classe client:

Per ulteriori informazioni sugli utenti di Amazon Redshift, consulta la guida introduttiva di Amazon Redshift.

Attività prerequisite

Per configurare ed eseguire questo esempio, è necessario completare queste attività:

  • Configura l'ambiente di progetto per eseguire questi TypeScript esempi di Node e installa i moduli richiesti AWS SDK for JavaScript e di terze parti. Segui le istruzioni su GitHub.

  • Creazione di un file di configurazione condiviso con le credenziali utente. Per ulteriori informazioni sulla fornitura di un file di credenziali condiviso, consulta File di configurazione e credenziali condivisi nella Guida di riferimento agli AWSSDK e agli strumenti.

Importante

Questi esempi dimostrano come importare/esportare oggetti e comandi del servizio client utilizzando ECMAScript6 (ES6).

Creazione di un cluster Amazon Redshift

Questo esempio dimostra come creare un cluster Amazon Redshift utilizzando. AWS SDK for JavaScript Per ulteriori informazioni, consulta. CreateCluster

Importante

Il cluster che state per creare è attivo (e non è in esecuzione in una sandbox). Saranno addebitati i costi standard di utilizzo di Amazon Redshift relativi al cluster finché non viene eliminato. Se elimini il cluster nella stessa sessione in cui lo hai creato, i costi totali sono minimi.

Create una libs directory e create un modulo Node.js con il nome del fileredshiftClient.js. Copia e incolla il codice seguente al suo interno, che crea l'oggetto client Amazon Redshift. Sostituisci REGION con la tua AWS regione.

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 };

Questo codice di esempio può essere trovato qui GitHub.

Crea un modulo Node.js con il nome del file redshift-create-cluster.js. Assicurati di configurare l'SDK come mostrato in precedenza, inclusa l'installazione dei client e dei pacchetti richiesti. Create un oggetto parametrico, specificando il tipo di nodo da assegnare e le credenziali di accesso principali per l'istanza di database creata automaticamente nel cluster e infine il tipo di cluster.

Nota

Sostituisci CLUSTER_NAME con il nome del cluster. Per NODE_TYPE, specificate il tipo di nodo da fornire, ad esempio 'dc2.large'. MASTER_USER_USER_PASSWORD sono le credenziali di accesso dell'utente master dell'istanza DB nel cluster. Per CLUSTER_TYPE, inserisci il tipo di cluster. Se lo specificatesingle-node, non è necessario il parametro. NumberOfNodes I parametri rimanenti sono opzionali. 

// 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();

Per eseguire l'esempio, immettere quanto segue al prompt dei comandi.

node redshift-create-cluster.js

Questo codice di esempio può essere trovato qui. GitHub

Modifica di un cluster Amazon Redshift

Questo esempio mostra come modificare la password dell'utente principale di un cluster Amazon Redshift utilizzando. AWS SDK for JavaScript Per ulteriori informazioni su quali altre impostazioni puoi modificare, consulta ModifyCluster.

Create una libs directory e create un modulo Node.js con il nome del fileredshiftClient.js. Copia e incolla il codice seguente al suo interno, che crea l'oggetto client Amazon Redshift. Sostituisci REGION con la tua AWS regione.

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 };

Questo codice di esempio può essere trovato qui GitHub.

Crea un modulo Node.js con il nome del file redshift-modify-cluster.js. Assicurati di configurare l'SDK come mostrato in precedenza, inclusa l'installazione dei client e dei pacchetti richiesti. Specificate la AWS regione, il nome del cluster che desiderate modificare e la nuova password dell'utente principale.

Nota

Sostituite CLUSTER_NAME con il nome del cluster e MASTER_USER_PASSWORD con la nuova password dell'utente principale. 

// 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();

Per eseguire l'esempio, immettete quanto segue al prompt dei comandi.

node redshift-modify-cluster.js

Questo codice di esempio può essere trovato qui. GitHub

Visualizzazione dei dettagli di un cluster Amazon Redshift

Questo esempio mostra come visualizzare i dettagli di un cluster Amazon Redshift utilizzando il. AWS SDK for JavaScript Per ulteriori informazioni su optional, consulta DescribeClusters.

Create una libs directory e create un modulo Node.js con il nome del fileredshiftClient.js. Copia e incolla il codice seguente al suo interno, che crea l'oggetto client Amazon Redshift. Sostituisci REGION con la tua AWS regione.

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 };

Questo codice di esempio può essere trovato qui GitHub.

Crea un modulo Node.js con il nome del file redshift-describe-clusters.js. Assicurati di configurare l'SDK come mostrato in precedenza, inclusa l'installazione dei client e dei pacchetti richiesti. Specificate la AWS regione, il nome del cluster che desiderate modificare e la nuova password dell'utente principale.

Nota

Sostituisci CLUSTER_NAME con il nome del cluster. 

// 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();

Per eseguire l'esempio, immettete quanto segue al prompt dei comandi.

node redshift-describe-clusters.js

Questo codice di esempio può essere trovato qui. GitHub

Eliminare un cluster Amazon Redshift

Questo esempio mostra come visualizzare i dettagli di un cluster Amazon Redshift utilizzando il. AWS SDK for JavaScript Per ulteriori informazioni su quali altre impostazioni puoi modificare, consulta DeleteCluster.

Create una libs directory e create un modulo Node.js con il nome del fileredshiftClient.js. Copia e incolla il codice seguente al suo interno, che crea l'oggetto client Amazon Redshift. Sostituisci REGION con la tua AWS regione.

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 };

Questo codice di esempio può essere trovato qui GitHub.

Crea un modulo Node.js con il nome del fileredshift-delete-clusters.js. Assicurati di configurare l'SDK come mostrato in precedenza, inclusa l'installazione dei client e dei pacchetti richiesti. Specificate la AWS regione, il nome del cluster che desiderate modificare e la nuova password dell'utente principale. Specificare se si desidera salvare un'istantanea finale del cluster prima dell'eliminazione e, in tal caso, l'ID dell'istantanea.

Nota

Sostituisci CLUSTER_NAME con il nome del cluster. Per il SkipFinalClusterSnapshot, specificare se creare un'istantanea finale del cluster prima di eliminarlo. Se specificate 'false', specificate l'id dell'istantanea finale del cluster in CLUSTER_SNAPSHOT_ID. È possibile ottenere questo ID facendo clic sul collegamento nella colonna Istantanee per il cluster nella dashboard dei cluster e scorrendo verso il basso fino al riquadro Snapshot. Nota che lo stem non rs: fa parte dell'ID dell'istantanea.

// 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();

Per eseguire l'esempio, immettete quanto segue al prompt dei comandi.

node redshift-delete-cluster.js

Questo codice di esempio può essere trovato qui. GitHub