AWS IoT TwinMaker Konektor data tabular Athena

Dengan konektor data tabular Athena, Anda dapat mengakses dan menggunakan penyimpanan data Athena Anda di. AWS IoT TwinMaker Anda dapat menggunakan data Athena Anda untuk membangun kembar digital tanpa upaya migrasi data yang intensif. Anda dapat menggunakan konektor bawaan atau membuat konektor Athena khusus untuk mengakses data dari sumber data Athena Anda.

AWS IoT TwinMaker Prasyarat konektor data Athena

Sebelum Anda menggunakan konektor data tabular Athena, lengkapi prasyarat berikut:

• Buat tabel Athena terkelola dan sumber daya Amazon S3 yang terkait. Untuk informasi tentang penggunaan Athena, lihat dokumentasi Athena.

• Buat AWS IoT TwinMaker ruang kerja. Anda dapat membuat ruang kerja di AWS IoT TwinMaker konsol.

• Perbarui peran IAM ruang kerja Anda dengan izin Athena. Untuk informasi selengkapnya, lihat Ubah peran IAM ruang kerja Anda untuk menggunakan konektor data Athena.

• Menjadi akrab dengan AWS IoT TwinMaker sistem komponen entitas dan cara membuat entitas. Untuk informasi selengkapnya, lihat Buat entitas pertama Anda.

• Menjadi akrab dengan AWS IoT TwinMaker konektor data. Untuk informasi selengkapnya, lihat AWS IoT TwinMaker konektor data.

Menggunakan konektor data Athena

Untuk menggunakan konektor data Athena, Anda harus membuat komponen, menggunakan konektor Athena sebagai tipe komponen. Kemudian Anda melampirkan komponen ke entitas dalam adegan Anda untuk digunakan dalam AWS IoT TwinMaker.

Buat tipe komponen dengan konektor data Athena

Gunakan prosedur ini untuk membuat tipe AWS IoT TwinMaker komponen dengan konektor data tabular Athena:

1. Navigasikan ke konsol AWS IoT TwinMaker tersebut.

2. Buka ruang kerja yang ada atau buat yang baru.

3. Dari menu navigasi sisi kiri, pilih Jenis komponen, dan pilih Buat tipe komponen untuk membuka halaman pembuatan tipe komponen.

4. Pada halaman Buat tipe komponen, isi kolom ID dengan ID yang cocok dengan kasus penggunaan Anda.

   

5. Pilih tipe Base. Dari daftar dropdown, pilih konektor data tabular Athena yang diberi label sebagai com.amazon.athena.connector.

6. Konfigurasikan sumber data tipe komponen dengan memilih sumber daya Athena untuk bidang berikut:

   • Pilih sumber data Athena.

   • Pilih database Athena.

   • Pilih nama Tabel.

   • Pilih Athena WorkGroup.

7. Setelah Anda memilih sumber daya Athena yang ingin Anda gunakan sebagai sumber data, pilih kolom mana dari tabel yang ingin Anda sertakan.

8. Pilih nama kolom ID Eksternal. Pilih kolom dari langkah sebelumnya untuk dijadikan kolom ID eksternal. Id eksternal adalah id yang digunakan untuk mewakili aset Athena dan memetakannya ke entitas AWS IoT TwinMaker .

   

9. (Opsional) Tambahkan AWS tag ke sumber daya ini, sehingga Anda dapat mengelompokkan dan mengaturnya.

10. Pilih Buat tipe komponen untuk menyelesaikan pembuatan tipe komponen.

Buat komponen dengan tipe konektor data Athena dan lampirkan ke entitas

Gunakan prosedur ini untuk membuat AWS IoT TwinMaker komponen dengan konektor data tabular Athena dan melampirkannya ke entitas:

catatan

Anda harus memiliki tipe komponen yang ada yang menggunakan konektor data tabular Athena sebagai sumber data untuk menyelesaikan prosedur ini. Lihat prosedur sebelumnya Buat tipe komponen dengan konektor data Athena sebelum memulai panduan ini.

1. Navigasikan ke konsol AWS IoT TwinMaker tersebut.

2. Buka ruang kerja yang ada atau buat yang baru.

3. Dari menu navigasi sisi kiri pilih Entitas, dan pilih entitas yang ingin Anda tambahkan komponen atau buat entitas baru.

4. Buat entitas baru.

5. Selanjutnya pilih Tambahkan komponen. , isi kolom Nama komponen dengan nama yang cocok dengan kasus penggunaan Anda.

6. Dari menu tarik-turun tipe Komponen pilih ID tipe komponen yang Anda buat di prosedur sebelumnya.

7. Masukkan informasi Komponen, Nama Komponen, dan pilih anak yang ComponentType dibuat sebelumnya. Ini adalah yang ComponentType Anda buat dengan konektor data Athena.

8. Di bagian Properties, masukkan athenaComponentExternalId untuk komponen.

   

9. Pilih Tambahkan komponen untuk menyelesaikan pembuatan komponen.

Anda sekarang telah berhasil membuat komponen dengan konektor data Athena sebagai tipe komponen dan melampirkannya ke entitas.

Menggunakan referensi JSON konektor data tabular Athena

Contoh berikut adalah referensi JSON lengkap untuk konektor data tabular Athena. Gunakan ini sebagai sumber daya untuk membuat konektor data kustom dan tipe komponen.

{
    "componentTypeId": "com.amazon.athena.connector",
    "description": "Athena connector for syncing tabular data",
    "workspaceId":"AmazonOwnedTypesWorkspace",
    "propertyGroups": {
        "tabularPropertyGroup": {
            "groupType": "TABULAR",
            "propertyNames": []
        }
    },
    "propertyDefinitions": {
        "athenaDataSource": {
            "dataType": { "type": "STRING" },
            "isRequiredInEntity": true
        },
        "athenaDatabase": {
            "dataType": { "type": "STRING" },
            "isRequiredInEntity": true
        },
        "athenaTable": {
            "dataType": { "type": "STRING" },
            "isRequiredInEntity": true
        },
        "athenaWorkgroup": {
            "dataType": { "type": "STRING" },
            "isRequiredInEntity": true
        },
        "athenaExternalIdColumnName": {
            "dataType": { "type": "STRING" },
            "isRequiredInEntity": true,
            "isExternalId": false
        },
        "athenaComponentExternalId": {
            "dataType": { "type": "STRING" },
            "isStoredExternally": false,
            "isRequiredInEntity": true,
            "isExternalId": true
        }
    },
    "functions": {
        "tabularDataReaderByEntity": {
            "implementedBy": {
                "isNative": true
            }
        }
    }
}

Menggunakan konektor data Athena

Anda dapat memunculkan entitas Anda yang menggunakan tabel Athena di Grafana. Untuk informasi selengkapnya, lihat Integrasi dasbor AWS IoT TwinMaker Grafana.

Baca dokumentasi Athena untuk informasi tentang membuat dan menggunakan tabel Athena untuk menyimpan data.

Memecahkan masalah konektor data Athena

Topik ini mencakup masalah umum yang mungkin Anda temui saat mengonfigurasi konektor data Athena.

Lokasi workgroup Athena:

Saat membuat konektor Athena ComponentType, workgroup Athena harus memiliki pengaturan lokasi keluaran. Lihat Cara kerja kelompok kerja.

Izin peran IAM tidak ada:

Peran AWS IoT TwinMaker; ruang kerja mungkin kehilangan izin akses API Athena saat membuat ComponentType, menambahkan komponen Ca ke entitas, atau menjalankan API. GetPropertyValue Untuk memperbarui izin IAM, lihat Membuat dan mengelola peran layanan. AWS IoT TwinMaker

Visualisasikan data tabular Athena di Grafana

Plugin Grafana juga tersedia untuk memvisualisasikan data tabular Anda di Grafana panel dasbor dengan fitur tambahan seperti penyortiran dan pemfilteran berdasarkan properti yang dipilih tanpa melakukan panggilan API ke, atau interaksi dengan Athena. AWS IoT TwinMaker Topik ini menunjukkan cara mengonfigurasi Grafana untuk memvisualisasikan data tabular Athena.

Prasyarat

Sebelum mengonfigurasi panel Grafana untuk memvisualisasikan data tabular Athena, tinjau prasyarat berikut:

• Anda telah menyiapkan lingkungan Grafana. Untuk informasi lebih lanjut lihat, Integrasi AWS IoT TwinMaker Grafana.

• Anda dapat mengonfigurasi sumber data Grafana. Untuk informasi lebih lanjut lihat, Grafana AWS IoT TwinMaker.

• Anda terbiasa membuat dasbor baru dan menambahkan panel baru.

Visualisasikan data tabular Athena di Grafana

Prosedur ini menunjukkan kepada Anda cara mengatur panel Grafana untuk memvisualisasikan data tabular Athena.

1. Buka dasbor AWS IoT TwinMaker Grafana Anda.

2. Pilih panel Tabel di pengaturan panel.

3. Pilih sumber data Anda dalam konfigurasi kueri.

4. Pilih kueri Dapatkan Nilai Properti.

5. Pilih entitas.

6. Pilih komponen yang memiliki ComponentType yang memperluas tipe komponen dasar Athena.

7. Pilih grup properti dari tabel Athena Anda.

8. Pilih sejumlah properti dari grup properti.

9. Konfigurasikan kondisi tabel melalui daftar filter dan pesanan properti. Dengan opsi berikut:

   • Filter: tentukan ekspresi untuk nilai properti untuk memfilter data Anda.

   • OrderBy: tentukan apakah data harus dikembalikan dalam urutan naik atau turun untuk properti.