Contoh Amazon Redshift - AWS SDK for JavaScript
Tugas prasyaratMembuat cluster Amazon RedshiftMemodifikasi cluster Amazon RedshiftMelihat detail cluster Amazon RedshiftMenghapus klaster Amazon Redshift

Panduan API Referensi AWS SDK for JavaScript V3 menjelaskan secara rinci semua API operasi untuk AWS SDK for JavaScript versi 3 (V3).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Contoh Amazon Redshift

Dalam contoh ini, serangkaian modul Node.js digunakan untuk membuat, memodifikasi, menjelaskan parameter, dan kemudian menghapus klaster Amazon Redshift menggunakan metode berikut dari kelas klien: Redshift

Untuk informasi selengkapnya tentang pengguna Amazon Redshift, lihat panduan memulai Amazon Redshift.

Tugas prasyarat

Untuk mengatur dan menjalankan contoh ini, Anda harus terlebih dahulu menyelesaikan tugas-tugas ini:

  • Siapkan lingkungan proyek untuk menjalankan TypeScript contoh Node ini, dan instal modul yang diperlukan AWS SDK for JavaScript dan pihak ketiga. Ikuti instruksi pada GitHub.

  • Buat file konfigurasi bersama dengan kredensi pengguna Anda. Untuk informasi selengkapnya tentang menyediakan file kredensial bersama, lihat File konfigurasi dan kredensial bersama di Panduan Referensi AWSSDK dan Alat.

penting

Contoh-contoh ini menunjukkan cara mengimpor/mengekspor objek dan perintah layanan klien menggunakan ECMAScript6 (ES6).

Membuat cluster Amazon Redshift

Contoh ini menunjukkan cara membuat cluster Amazon Redshift menggunakan file. AWS SDK for JavaScript Untuk informasi lebih lanjut, lihat CreateCluster.

penting

Cluster yang akan Anda buat adalah live (dan tidak berjalan di kotak pasir). Anda dikenakan biaya penggunaan Amazon Redshift standar untuk klaster hingga Anda menghapusnya. Jika Anda menghapus cluster di tempat yang sama seperti saat Anda membuatnya, total biaya minimal.

Buat libs direktori, dan buat modul Node.js dengan nama fileredshiftClient.js. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti REGION dengan AWS Region Anda.

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

Kode contoh ini dapat ditemukan di sini GitHub.

Buat modul Node.js dengan nama fileredshift-create-cluster.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk menginstal klien dan paket yang diperlukan. Buat objek parameter, tentukan tipe node yang akan disediakan, dan kredenal masuk master untuk instance database yang dibuat secara otomatis di cluster, dan terakhir tipe cluster.

catatan

Ganti CLUSTER_NAME dengan nama cluster. Untuk NODE_TYPE tentukan tipe node yang akan disediakan, seperti 'dc2.large', misalnya. MASTER_USERNAME dan MASTER_USER_PASSWORD adalah kredensi masuk dari pengguna utama instans DB Anda di cluster. Untuk CLUSTER_TYPE, masukkan tipe cluster. Jika Anda menentukansingle-node, Anda tidak memerlukan NumberOfNodes parameter. Parameter yang tersisa adalah opsional. 

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

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node redshift-create-cluster.js

Kode contoh ini dapat ditemukan di sini GitHub.

Memodifikasi cluster Amazon Redshift

Contoh ini menunjukkan cara memodifikasi kata sandi pengguna utama cluster Amazon Redshift menggunakan file. AWS SDK for JavaScript Untuk informasi selengkapnya tentang pengaturan lain yang dapat Anda ubah, lihat ModifyCluster.

Buat libs direktori, dan buat modul Node.js dengan nama fileredshiftClient.js. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti REGION dengan AWS Region Anda.

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

Kode contoh ini dapat ditemukan di sini GitHub.

Buat modul Node.js dengan nama fileredshift-modify-cluster.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk menginstal klien dan paket yang diperlukan. Tentukan AWS Wilayah, nama cluster yang ingin Anda modifikasi, dan kata sandi pengguna master baru.

catatan

Ganti CLUSTER_NAME dengan nama cluster, dan MASTER_USER_PASSWORD dengan kata sandi pengguna master baru. 

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

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node redshift-modify-cluster.js

Kode contoh ini dapat ditemukan di sini GitHub.

Melihat detail cluster Amazon Redshift

Contoh ini menunjukkan cara melihat detail cluster Amazon Redshift menggunakan file. AWS SDK for JavaScript Untuk informasi lebih lanjut tentang opsional, lihat DescribeClusters.

Buat libs direktori, dan buat modul Node.js dengan nama fileredshiftClient.js. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti REGION dengan AWS Region Anda.

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

Kode contoh ini dapat ditemukan di sini GitHub.

Buat modul Node.js dengan nama fileredshift-describe-clusters.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk menginstal klien dan paket yang diperlukan. Tentukan AWS Wilayah, nama cluster yang ingin Anda modifikasi, dan kata sandi pengguna master baru.

catatan

Ganti CLUSTER_NAME dengan nama 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();

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node redshift-describe-clusters.js

Kode contoh ini dapat ditemukan di sini GitHub.

Menghapus klaster Amazon Redshift

Contoh ini menunjukkan cara melihat detail cluster Amazon Redshift menggunakan file. AWS SDK for JavaScript Untuk informasi selengkapnya tentang pengaturan lain yang dapat Anda ubah, lihat DeleteCluster.

Buat libs direktori, dan buat modul Node.js dengan nama fileredshiftClient.js. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti REGION dengan AWS Region Anda.

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

Kode contoh ini dapat ditemukan di sini GitHub.

Buat modul Node.js dengan file bernamaredshift-delete-clusters.js. Pastikan untuk mengonfigurasi SDK seperti yang ditunjukkan sebelumnya, termasuk menginstal klien dan paket yang diperlukan. Tentukan AWS Wilayah, nama cluster yang ingin Anda modifikasi, dan kata sandi pengguna master baru. Tentukan apakah Anda ingin menyimpan snapshot akhir cluster sebelum menghapus, dan jika demikian ID snapshot.

catatan

Ganti CLUSTER_NAME dengan nama cluster. Untuk SkipFinalClusterSnapshot, tentukan apakah akan membuat snapshot akhir cluster sebelum menghapusnya. Jika Anda menentukan 'false', tentukan id snapshot cluster terakhir di CLUSTER_SNAPSHOT_ID. Anda bisa mendapatkan ID ini dengan mengklik tautan di kolom Snapshots untuk cluster di dasbor Clusters, dan menggulir ke bawah ke panel Snapshots. Perhatikan bahwa batang rs: bukan bagian dari ID snapshot.

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

Untuk menjalankan contoh, masukkan yang berikut ini di command prompt.

node redshift-delete-cluster.js

Kode contoh ini dapat ditemukan di sini GitHub.