[Panduan Referensi API AWS SDK untuk JavaScript V3](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/) menjelaskan secara rinci semua operasi API untuk AWS SDK untuk 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
Amazon Redshift adalah layanan gudang data dengan skala petabyte yang terkelola penuh di cloud. *Gudang data Amazon Redshift adalah kumpulan sumber daya komputasi yang disebut *node*, yang diatur ke dalam grup yang disebut cluster.* Setiap klaster menjalankan mesin Amazon Redshift dan berisi satu atau lebih database.
![\[Hubungan antara JavaScript lingkungan, SDK, dan Amazon Redshift\]](http://docs.aws.amazon.com/id_id/sdk-for-javascript/v3/developer-guide/images/code-samples-redshift.png)
JavaScript API untuk Amazon Redshift diekspos melalui kelas klien [Amazon Redshift](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/Redshift/).
**Topics**
+ [Contoh Amazon Redshift](redshift-examples-section.md)
# 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`
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/CreateClusterCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/CreateClusterCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/ModifyClusterCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/ModifyClusterCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DescribeClustersCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DescribeClustersCommand/)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DeleteClusterCommand/](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/Package/-aws-sdk-client-redshift/Class/DeleteClusterCommand/)
Untuk informasi selengkapnya tentang pengguna Amazon Redshift, lihat panduan memulai [Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/gsg/getting-started.html).
## 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 untuk JavaScript dan pihak ketiga. Ikuti instruksi pada [ GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/redshift/README.md).
+ 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 Alat](https://docs.aws.amazon.com/sdkref/latest/guide/file-format.html) dan Alat.AWS SDKs *
**penting**
Contoh-contoh ini menunjukkan bagaimana mengimpor/mengekspor objek layanan klien dan perintah menggunakan ECMAScript6 ()ES6.
Ini membutuhkan Node.js versi 13.x atau lebih tinggi. Untuk mengunduh dan menginstal versi terbaru dari Node.js, lihat [unduhan Node.js.](https://nodejs.org/en/download) .
Jika Anda lebih suka menggunakan sintaks CommonJS, lihat [JavaScript ES6/CommonJS sintaks](sdk-example-javascript-syntax.md)
## Membuat cluster Amazon Redshift
Contoh ini menunjukkan cara membuat cluster Amazon Redshift menggunakan file. AWS SDK untuk JavaScript Untuk informasi selengkapnya, lihat [CreateCluster](https://docs.aws.amazon.com/redshift/latest/APIReference/API_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 file`redshiftClient.js`. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti *REGION* dengan AWS wilayah 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js).
Buat modul Node.js dengan nama file`redshift-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\$1NAME* dengan nama cluster. Untuk *NODE\$1TYPE* menentukan jenis node yang akan disediakan, seperti 'dc2.large', misalnya. *MASTER\$1USERNAME*dan *MASTER\$1USER\$1PASSWORD* merupakan kredensional masuk dari pengguna utama instans DB Anda di cluster. Untuk*CLUSTER\$1TYPE*, masukkan jenis cluster. Jika Anda menentukan`single-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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-create-cluster.js).
## Memodifikasi cluster Amazon Redshift
Contoh ini menunjukkan cara memodifikasi kata sandi pengguna utama cluster Amazon Redshift menggunakan. AWS SDK untuk JavaScript Untuk informasi selengkapnya tentang pengaturan lain yang dapat Anda ubah, lihat [ModifyCluster](https://docs.aws.amazon.com/redshift/latest/APIReference/API_ModifyCluster.html).
Buat `libs` direktori, dan buat modul Node.js dengan nama file`redshiftClient.js`. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti *REGION* dengan AWS wilayah 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js).
Buat modul Node.js dengan nama file`redshift-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\$1NAME* dengan nama cluster, dan *MASTER\$1USER\$1PASSWORD* 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-modify-cluster.js).
## Melihat detail cluster Amazon Redshift
Contoh ini menunjukkan cara melihat detail cluster Amazon Redshift menggunakan file. AWS SDK untuk JavaScript Untuk informasi lebih lanjut tentang opsional, lihat [DescribeClusters](https://docs.aws.amazon.com/redshift/latest/APIReference/API_DescribeClusters.html).
Buat `libs` direktori, dan buat modul Node.js dengan nama file`redshiftClient.js`. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti *REGION* dengan AWS wilayah 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js).
Buat modul Node.js dengan nama file`redshift-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\$1NAME* 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-describe-clusters.js).
## Menghapus klaster Amazon Redshift
Contoh ini menunjukkan cara melihat detail cluster Amazon Redshift menggunakan file. AWS SDK untuk JavaScript Untuk informasi selengkapnya tentang pengaturan lain yang dapat Anda ubah, lihat [DeleteCluster](https://docs.aws.amazon.com/redshift/latest/APIReference/API_DeleteCluster.html).
Buat `libs` direktori, dan buat modul Node.js dengan nama file`redshiftClient.js`. Salin dan tempel kode di bawah ini ke dalamnya, yang membuat objek klien Amazon Redshift. Ganti *REGION* dengan AWS wilayah 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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/libs/redshiftClient.js).
Buat modul Node.js dengan file bernama`redshift-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\$1NAME* 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\$1SNAPSHOT\$1ID*. **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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/javascriptv3/example_code/redshift/src/redshift-delete-cluster.js).