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

# Connect ke sumber data Snowflake
<a name="snowflake-datasource-for-AMG"></a>

 Dengan sumber data Snowflake Enterprise, Anda dapat memvisualisasikan data Snowflake Anda bersama semua sumber data Anda yang lain di Grafana serta data log dan metrik dalam konteks. Sumber data ini mencakup editor kueri tipe-depan yang kuat, mendukung anotasi kompleks, menetapkan ambang peringatan, mengontrol akses dan izin, dan banyak lagi. 

**catatan**  
Sumber data ini hanya untuk Grafana Enterprise. Untuk informasi selengkapnya, lihat [Mengelola akses ke plugin Enterprise](upgrade-to-enterprise-plugins.md).  
Selain itu, di ruang kerja yang mendukung versi 9 atau yang lebih baru, sumber data ini mungkin mengharuskan Anda untuk menginstal plugin yang sesuai. Untuk informasi selengkapnya, lihat [Perluas ruang kerja Anda dengan plugin](grafana-plugins.md).

## Ikhtisar
<a name="snowflake-overview"></a>

### Apa itu Kepingan Salju?
<a name="what-is-snowflake"></a>

 Snowflake menawarkan layanan penyimpanan dan analisis data berbasis cloud, umumnya disebut “data warehouse-as-a-service” yang menawarkan solusi untuk pergudangan data, data lake, rekayasa data, ilmu data, pengembangan aplikasi data, dan berbagi data. Selama beberapa tahun terakhir, Snowflake telah mendapatkan popularitas besar karena kemampuannya untuk menyimpan dan menganalisis data dengan harga terjangkau menggunakan perangkat keras dan perangkat lunak berbasis cloud; baru-baru ini berpuncak pada IPO perangkat lunak terbesar yang pernah ada. Saat ini, banyak perusahaan menggunakan Snowflake sebagai database utama mereka untuk menyimpan data aplikasi dan bisnis seperti jumlah transaksi, sesi pengguna aktif, dan bahkan deret waktu dan data metrik. 

### Memanfaatkan Snowflake dan Grafana yang Dikelola Amazon
<a name="making-the-most-of-snowflake-and-AMG"></a>

 **Visualisasikan data Snowflake tanpa memindahkannya**: Arsitektur unik Grafana menanyakan data secara langsung di tempat tinggalnya daripada memindahkannya dan membayar penyimpanan dan konsumsi yang berlebihan. 

 **Buat panel dari berbagai sumber:** Dengan dasbor pra-bangun dan kustom, satukan data dari berbagai sumber data ke dalam satu panel kaca. 

 **Transformasi dan komputasi di tingkat pengguna**: Pengguna dapat mengubah data dan menjalankan berbagai perhitungan pada data yang mereka lihat, membutuhkan lebih sedikit persiapan data. 

 **Menggabungkan, menghitung, dan memvisualisasikan dalam panel: Buat panel** sumber data campuran yang menampilkan data terkait dari Snowflake dan sumber lainnya. 

### Fitur
<a name="snowflake-features"></a>

 **Editor kueri: Editor** kueri adalah editor pelengkapan otomatis Smart SQL yang memungkinkan Anda memvisualisasikan deret waktu atau data tabel, menangani kesalahan sintaks SQL, dan melengkapi kata kunci SQL dasar secara otomatis. 

 **Izin sumber data**: Kontrol siapa yang dapat melihat atau menanyakan data Kepingan Salju di Grafana 

 **Anotasi:** Hamparkan peristiwa Kepingan Salju pada grafik Grafana apa pun, untuk mengkorelasikan peristiwa dengan data grafik lainnya 

 **Peringatan:** Setel toko metrik berbasis peringatan di Snowflake 

 **Variabel untuk kueri:** Buat variabel template di Grafana berdasarkan data Snowflake, dan sertakan variabel dalam kueri Snowflake untuk membuat dasbor interaktif. 

 **Kueri multi-metrik:** Tulis satu kueri yang mengembalikan beberapa metrik, masing-masing di kolomnya sendiri 

## Memulai dengan plugin Snowflake
<a name="get-started-with-the-snowflake-plugin"></a>

 Berikut adalah lima langkah cepat untuk memulai plugin Snowflake di Grafana: 

### Langkah 1: Siapkan Sumber Data Snowflake
<a name="set-up-the-snowflake-data-source"></a>

 Untuk mengkonfigurasi sumber data, pilih **Konfigurasi**, **Sumber Data**, **Tambahkan sumber data**, kepingan salju. 

 Tambahkan detail otentikasi Anda, dan sumber data siap untuk ditanyakan\$1 

 Bidang konfigurasi berikut tersedia. 


|  Nama  |  Deskripsi  | 
| --- | --- | 
|  Akun  |  Akun untuk Snowflake.  | 
|  nama pengguna  |  Nama pengguna untuk akun layanan.  | 
|  Kata Sandi  |  Kata sandi untuk akun layanan.  | 
|  Skema (opsional)  |  Menetapkan skema default untuk kueri.  | 
|  Gudang (opsional)  |  Menetapkan gudang default untuk kueri.  | 
|  Database (opsional)  |  Menetapkan database default untuk query.  | 
|  Peran (opsional)  |  Mengasumsikan peran untuk kueri.  | 

### Langkah 2: Tulis kueri untuk data Snowflake Anda
<a name="write-queries-for-your-snowflake-data"></a>

 Buat panel di dasbor, dan pilih Sumber Data Kepingan Salju untuk mulai menggunakan editor kueri. 
+  Tanggal/waktu dapat muncul di mana saja dalam kueri selama disertakan. 
+  Kolom numerik harus disertakan. Ini bisa berupa agregasi atau int/float kolom. 
+  Secara opsional, Anda dapat menyertakan kolom string untuk membuat seri data terpisah, jika data deret waktu Anda diformat untuk metrik yang berbeda. 

#### Tata letak kueri Snowflake
<a name="layout-of-a-snowflake-query"></a>

```
select
  <time_column>,
  <any_numerical_column>
  <other_column_1>,
  <other_column_2>,
  <...>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

#### Format kueri SQL untuk grup deret waktu berdasarkan interval
<a name="sql-query-format-for-timeseries-group-by-interval"></a>

```
select
  $__timeGroup(created_ts, '1h'), // group time by interval of 1h
  <time_column>, 
  <any_numerical_column>,
  <metric_column>
from
  <any_table>
where
  $__timeFilter(<time_column>) // predefined where clause for time range
  and $<custom_variable> = 1 // custom variables start with dollar sign
group by <time_column>
```

#### Format kueri SQL untuk tabel
<a name="sql-query-format-for-tables"></a>

```
select
  <time_column>, // optional if result format option is table
  <any_column_1>
  <any_column_2>
  <any_column_3>
from
  <any_table>
where
  $__timeFilter(time_column) // macro for time range, optional if format as option is table
  and $<custom_variable> = 1 // custom variables start with dollar sign
```

### Langkah 3: Buat dan gunakan Variabel Template
<a name="snowflake-create-and-use-template-variables"></a>

#### Menggunakan variabel template
<a name="snowflake-using-template-variables-1"></a>

 Anda dapat menyertakan variabel template dalam query, seperti yang ditunjukkan pada contoh berikut. 

```
 select
   <column>
 from 
   <table>
 WHERE column >= '$variable'
```

 Contoh berikut menunjukkan menggunakan variabel multi-nilai dalam query. 

```
select
  <column>
from 
  <table>
WHERE <column> regexp '${variable:regex}'
```

#### Menggunakan sumber data Snowflake untuk membuat variabel
<a name="using-the-snowflake-datasource-to-create-variables"></a>

 Di pengaturan dasbor, pilih **Variabel**, dan pilih **Baru**. 

 Menggunakan tipe variabel “Query”, pilih sumber data Snowflake sebagai “Sumber data”. 

**penting**  
 Pastikan untuk memilih hanya satu kolom dalam kueri variabel Anda. 

 Contoh: 

```
SELECT DISTINCT query_type from account_usage.query_history;
```

 akan memberi Anda variabel-variabel ini: 

```
All DESCRIBE USE UNKNOWN GRANT SELECT CREATE DROP SHOW
```

### Langkah 4: Siapkan peringatan
<a name="snowflake-set-up-an-alert"></a>

 Anda dapat mengatur peringatan pada metrik Snowflake tertentu atau pada kueri yang telah Anda buat. 

 Pilih tombol tab peringatan di dalam editor kueri, dan pilih **Buat Peringatan**. 

### Langkah 5. Buat anotasi
<a name="snowflake-create-an-annotation"></a>

 Anotasi memungkinkan Anda untuk melapisi peristiwa pada grafik. 

 Untuk membuat anotasi, di pengaturan dasbor, pilih **Anotasi**, dan **Baru**, dan pilih Snowflake sebagai sumber data. 

 Karena anotasi adalah peristiwa, mereka memerlukan setidaknya satu kolom waktu dan satu kolom untuk menggambarkan peristiwa tersebut. 

 Kode contoh berikut menunjukkan kueri untuk membubuhi keterangan semua login yang gagal ke Snowflake. 

```
SELECT
  EVENT_TIMESTAMP as time,
  EVENT_TYPE,
  CLIENT_IP
FROM ACCOUNT_USAGE.LOGIN_HISTORY
WHERE $__timeFilter(time) AND IS_SUCCESS!='YES'
ORDER BY time ASC;
```

 Dan 
+  waktu: `TIME` 
+  judul: `EVENT_TYPE` 
+  teks: `CLIENT_IP` 

 Ini akan melapisi anotasi semua login yang gagal ke Snowflake di panel dasbor Anda. 

## Fungsionalitas tambahan
<a name="additional-functionality"></a>

### Menggunakan bidang Nama Tampilan
<a name="snowflake-using-display-name"></a>

 Plugin ini menggunakan bidang Nama Tampilan di tab Bidang panel Opsi untuk mempersingkat atau mengubah kunci legenda berdasarkan nama, label, atau nilainya. Sumber data lain menggunakan `alias` fungsionalitas khusus untuk memodifikasi kunci legenda, tetapi fungsi Nama Tampilan adalah cara yang lebih konsisten untuk melakukannya. 

### Izin sumber data
<a name="snowflake-data-source-permissions"></a>

 Batasi akses ke Snowflake dengan memilih tab Izin di halaman konfigurasi sumber data untuk mengaktifkan **izin** sumber data. Pada halaman izin, Admin dapat mengaktifkan izin dan membatasi izin kueri untuk Pengguna dan Tim tertentu. 

### Memahami data penagihan dan penggunaan Snowflake Anda
<a name="understand-your-snowflake-billing-and-usage-data"></a>

 Dalam sumber data Snowflake, Anda dapat mengimpor dasbor penagihan dan penggunaan yang menunjukkan informasi penagihan dan penggunaan yang berguna. 

 Tambahkan dasbor di halaman konfigurasi Sumber Data Snowflake: 

 Dasbor ini menggunakan database ACCOUNT\$1USAGE, dan membutuhkan querier untuk memiliki peran ACCOUNTADMIN. Untuk melakukan ini dengan aman, buat sumber data Grafana baru yang memiliki pengguna dengan peran ACCOUNTADMIN. Kemudian pilih sumber data tersebut di variabel.