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

# Migrasi objek yang disimpan dari OpenSearch Dasbor ke UI OpenSearch
<a name="application-migration"></a>

Jika Anda memiliki dasbor, visualisasi, pola indeks, dan objek lain yang disimpan di OpenSearch Dasbor, Anda dapat memigrasi dan menggunakannya kembali di UI. OpenSearch 

Manfaat migrasi ke OpenSearch UI:
+ **Ketersediaan tinggi** — OpenSearch UI di-host di AWS Cloud dan tetap tersedia selama peningkatan dan pemeliharaan domain, sementara OpenSearch Dasbor di-host dalam domain dan untuk sementara tidak tersedia.
+ **Beberapa Sumber Data** — OpenSearch UI dapat menyediakan satu panel kaca terkonsolidasi di berbagai sumber data, termasuk OpenSearch domain, koleksi tanpa server, dan koneksi data dengan Amazon S3 dan CloudWatch Amazon; sementara OpenSearch setiap Dasbor hanya dapat berfungsi dengan satu domain atau koleksi.
+ Fitur tambahan seperti AI Assistant dan Workspaces tersedia di OpenSearch UI. Pelajari lebih lanjut:[Menggunakan OpenSearch UI di Amazon OpenSearch Service](application.md).

**Topics**
+ [Ikhtisar migrasi](#application-migrate-saved-objects-overview)
+ [Prasyarat](#application-migrate-saved-objects-prerequisites)
+ [Langkah 1: Ekspor objek yang disimpan dari OpenSearch Dasbor](#application-migrate-saved-objects-export)
+ [Langkah 2: Impor objek yang disimpan ke OpenSearch UI](#application-migrate-saved-objects-import)

## Ikhtisar migrasi
<a name="application-migrate-saved-objects-overview"></a>

Proses migrasi terdiri dari langkah-langkah tingkat tinggi berikut:

1. **Ekspor objek yang disimpan dari OpenSearch Dasbor** — Gunakan UI manajemen Objek Tersimpan OpenSearch Dasbor atau API ekspor untuk mengunduh dasbor, visualisasi, pola indeks, dan objek lainnya sebagai file JSON (NDJSON) yang dibatasi baris baru.

1. **Buat aplikasi OpenSearch UI dan ruang kerja** - Jika Anda belum melakukannya, buat aplikasi OpenSearch UI dan ruang kerja untuk menerima objek yang diimpor.

1. **Daftarkan sumber data di OpenSearch UI** — Kaitkan OpenSearch domain Anda dengan aplikasi OpenSearch UI dan daftarkan sebagai sumber data di dalam ruang kerja. Pola indeks dalam objek impor Anda mereferensikan sumber data ini.

1. **Impor objek yang disimpan ke OpenSearch UI** — Gunakan OpenSearch UI manajemen Objek Tersimpan UI atau API impor untuk mengunggah file NDJSON ke ruang kerja target.

1. **Validasi objek yang diimpor** — Buka dasbor dan visualisasi Anda di OpenSearch UI untuk memverifikasi bahwa objek tersebut ditampilkan dengan benar dan data tersebut mengalir dari domain atau koleksi terkait.

## Prasyarat
<a name="application-migrate-saved-objects-prerequisites"></a>

Sebelum migrasi, verifikasi prasyarat berikut:
+ Anda memiliki izin IAM yang diperlukan untuk memanggil OpenSearch Layanan Amazon dan. OpenSearch APIs Untuk informasi selengkapnya, lihat [Izin yang diperlukan untuk membuat aplikasi OpenSearch Layanan Amazon](application-getting-started.md#application-prerequisite-permissions).
+ Anda dapat mengakses domain atau koleksi dan OpenSearch Dasbor yang ingin Anda migrasi.
+ Anda telah membuat aplikasi OpenSearch UI. Untuk informasi tentang membuat aplikasi dan ruang kerja, lihat[Memulai antarmuka OpenSearch pengguna di Amazon OpenSearch Service](application-getting-started.md).
+ Anda telah mengaitkan domain atau koleksi yang sama ke aplikasi OpenSearch UI. Untuk informasi tentang mengaitkan sumber data, lihat[Mengelola asosiasi sumber data dan izin akses Virtual Private Cloud](application-data-sources-and-vpc.md).

**catatan**  
OpenSearch UI hanya mendukung OpenSearch versi 1.3 dan yang lebih baru. Verifikasi bahwa OpenSearch domain Anda menjalankan versi 1.3 atau lebih tinggi sebelum mencoba memigrasi objek yang disimpan.

## Langkah 1: Ekspor objek yang disimpan dari OpenSearch Dasbor
<a name="application-migrate-saved-objects-export"></a>

Ekspor objek yang disimpan dari OpenSearch Dasbor menggunakan UI manajemen atau API ekspor. Ekspor menghasilkan file JSON (NDJSON) yang dibatasi baris baru yang berisi semua jenis objek tersimpan yang dipilih dan dependensinya.

**Topics**
+ [Ekspor secara manual di OpenSearch Dasbor](#application-migrate-export-console)
+ [Mengekspor melalui API](#application-migrate-export-api)

### Ekspor secara manual di OpenSearch Dasbor
<a name="application-migrate-export-console"></a>

**Untuk mengekspor objek yang disimpan menggunakan UI manajemen OpenSearch Dasbor**

1. Buka instance OpenSearch Dasbor Anda.

1. Di panel navigasi kiri, pilih **Manajemen**.

1. Di bawah **Manajemen Dasbor**, pilih **Objek Tersimpan**.

1. Pilih objek yang disimpan yang ingin Anda ekspor. Untuk mengekspor semua objek dari jenis tertentu, filter berdasarkan jenis menggunakan bilah pencarian. Untuk mengekspor semua objek, pilih kotak centang di header tabel.

1. Pilih **Ekspor**.

1. Dalam kotak dialog **Ekspor objek yang disimpan**, pastikan bahwa **Sertakan objek terkait** dipilih. Opsi ini mencakup semua objek yang bergantung pada objek tersimpan yang dipilih, seperti pola indeks yang direferensikan oleh visualisasi. Hapus opsi ini hanya jika Anda bermaksud mengelola dependensi secara manual.

1. Pilih **Ekspor** untuk mengunduh `.ndjson` file ke mesin lokal Anda.

**Tip**  
Saat Anda memilih **Sertakan objek terkait**, file NDJSON yang diekspor berisi semua objek tersimpan yang diperlukan untuk merender dasbor dan visualisasi yang dipilih, termasuk pola indeks dependennya, visualisasi, dan objek pencarian. Ini menyederhanakan langkah impor dan menghindari kesalahan referensi yang hilang.

### Mengekspor melalui API
<a name="application-migrate-export-api"></a>

Anda dapat menggunakan API ekspor Objek Tersimpan OpenSearch Dasbor untuk mengekspor objek yang disimpan secara terprogram. Ini berguna untuk mengotomatiskan migrasi atau mengintegrasikan langkah ekspor ke dalam pipeline. CI/CD 

**catatan**  
Jika OpenSearch domain Anda telah mengaktifkan [kontrol akses berbutir halus](fgac.md), Anda harus memberikan kredensi otentikasi dengan permintaan ekspor Anda. Gunakan otentikasi dasar HTTP dengan menambahkan `-u` bendera dengan nama pengguna dan kata sandi Anda. Untuk informasi selengkapnya tentang opsi otentikasi, lihat[Kontrol akses berbutir halus di Layanan Amazon OpenSearch](fgac.md).

Contoh berikut mengekspor semua dasbor dengan objek terkait. Ganti *placeholder values* dengan informasi Anda sendiri.

```
curl -X POST \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \
    -u 'master-username:master-password' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "type": ["dashboard", "visualization", "index-pattern", "search"],
        "includeReferencesDeep": true,
        "excludeExportDetails": false
    }' \
    -o saved-objects-export.ndjson
```

Jika domain Anda tidak mengaktifkan kontrol akses berbutir halus, Anda dapat menghilangkan bendera. `-u`

Untuk mengekspor objek tertentu yang disimpan berdasarkan ID, gunakan `objects` parameter alih-alih`type`:

```
curl -X POST \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_export" \
    -u 'master-username:master-password' \
    -H "Content-Type: application/json" \
    -H "osd-xsrf: true" \
    -d '{
        "objects": [
            {"type": "dashboard", "id": "dashboard-id"},
            {"type": "visualization", "id": "visualization-id"}
        ],
        "includeReferencesDeep": true
    }' \
    -o saved-objects-export.ndjson
```

**catatan**  
Untuk menemukan objek yang disimpan IDs, Anda dapat menggunakan Saved Objects API untuk mencantumkan semua objek dari tipe tertentu. Contoh berikut mencantumkan semua dasbor:  

```
curl -X GET \
    "https://dashboards-endpoint/_dashboards/api/saved_objects/_find?type=dashboard" \
    -u 'master-username:master-password'
```
Respons termasuk ID untuk setiap objek yang disimpan. Anda juga dapat menemukan ID di URL browser saat melihat objek di OpenSearch Dasbor.

## Langkah 2: Impor objek yang disimpan ke OpenSearch UI
<a name="application-migrate-saved-objects-import"></a>

Setelah mengekspor objek yang disimpan, Anda dapat mengimpor file NDJSON ke OpenSearch UI secara manual atau melalui API.

**Topics**
+ [Impor secara manual di OpenSearch UI](#application-migrate-import-console)
+ [Impor melalui API](#application-migrate-import-api)

### Impor secara manual di OpenSearch UI
<a name="application-migrate-import-console"></a>

**Untuk mengimpor objek yang disimpan menggunakan OpenSearch UI manajemen UI**

1. Buka aplikasi OpenSearch UI Anda dan arahkan ke ruang kerja target.

1. Di ruang kerja, pilih **Aset** dari navigasi atas atau buka halaman aset ruang kerja.

1. Pilih **Impor** untuk membuka dialog **Impor aset**.

1. Pilih **Pilih file** dan pilih `.ndjson` file yang Anda ekspor dari OpenSearch Dasbor.

1. Untuk **manajemen Konflik**, pilih salah satu dari berikut ini:
   + **Buat aset baru dengan unik IDs** (default) - Menghasilkan baru IDs untuk semua objek yang diimpor, menghindari konflik dengan aset yang ada.
   + **Periksa aset yang ada** — Memeriksa konflik dengan objek yang ada. Saat dipilih, pilih salah satu dari sub-opsi berikut:
     + **Menimpa konflik secara otomatis** - Aset yang ada dengan ID yang sama diganti secara otomatis.
     + **Meminta tindakan atas konflik** — Anda diminta untuk menyelesaikan setiap konflik secara individual.

1. Pilih **Impor**.

1. Tinjau ringkasan impor.

### Impor melalui API
<a name="application-migrate-import-api"></a>

Untuk mengimpor objek yang disimpan menggunakan API dengan otentikasi AWS Signature Version 4, Anda harus terlebih dahulu mendapatkan ID sumber data, lalu menggunakannya dalam permintaan impor. Ganti *placeholder values* dengan informasi Anda sendiri.

Langkah 1: Dapatkan ID sumber data untuk ruang kerja Anda:

```
curl -X GET \
    "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_find?type=data-source" \
    --aws-sigv4 "aws:amz:region:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true"
```

**catatan**  
Respons termasuk ID sumber data. Anda juga dapat menemukan ID sumber data di URL browser saat melihat sumber data di OpenSearch UI.

Langkah 2: Impor objek yang disimpan menggunakan ID sumber data dari Langkah 1:

```
curl -X POST \
    "https://opensearch-ui-endpoint/w/workspace-id/api/saved_objects/_import?overwrite=true&dataSourceId=data-source-id" \
    --aws-sigv4 "aws:amz:region:opensearch" \
    --user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
    -H "x-amz-security-token: $AWS_SESSION_TOKEN" \
    -H "osd-xsrf: true" \
    -F "file=@saved-objects-export.ndjson"
```

**catatan**  
Contoh-contoh ini menggunakan `--aws-sigv4` opsi bawaan curl (tersedia di curl 7.75 atau yang lebih baru) untuk menandatangani permintaan. Tetapkan AWS kredensil Anda sebagai variabel lingkungan sebelum menjalankan perintah:`AWS_ACCESS_KEY_ID`,`AWS_SECRET_ACCESS_KEY`, dan `AWS_SESSION_TOKEN` (jika menggunakan kredensil sementara).