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

# Membaca dari entitas Google Analytics 4
<a name="googleanalytics-reading-from-entities"></a>

 **Prasyarat** 
+  Objek Google Analytics 4 yang ingin Anda baca. Lihat tabel entitas yang didukung di bawah ini untuk memeriksa entitas yang tersedia. 

 **Entitas yang didukung** 


| Entitas | Dapat disaring | Mendukung Batas | Mendukung Order By | Mendukung Pilih\* | Mendukung Partisi | 
| --- | --- | --- | --- | --- | --- | 
| Laporan Real-Time | Ya | Ya | Ya | Ya | Tidak | 
| Laporan Inti | Ya | Ya | Ya | Ya | Ya | 

 **Contoh** 

```
googleAnalytics4_read = glueContext.create_dynamic_frame.from_options(
    connection_type="GoogleAnalytics4",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "entityName",
        "API_VERSION": "v1beta"
    }
```

 **Detail entitas dan bidang Google Analytics 4** 


| Entitas | Field | Tipe data | Operator yang Didukung | 
| --- | --- | --- | --- | 
| Laporan Inti | Bidang Dinamis |  |  | 
| Laporan Inti | Bidang Dimensi | String | SEPERTI, = | 
| Laporan Inti | Bidang Dimensi | Date | SEPERTI, = | 
| Laporan Inti | Bidang Metrik | String | >, <, >=, <=, = ANTARA | 
| Laporan Inti | Dimensi Kustom dan Bidang Metrik Kustom | String | TA | 
| Laporan Real-Time | AppVersion | String | SEPERTI, = | 
| Laporan Real-Time | AudienceID | String | SEPERTI, = | 
| Laporan Real-Time | Nama Pemirsa | String | SEPERTI, = | 
| Laporan Real-Time | kota | String | SEPERTI, = | 
| Laporan Real-Time | CityID | String | SEPERTI, = | 
| Laporan Real-Time | negeri | String | SEPERTI, = | 
| Laporan Real-Time | CountryID | String | SEPERTI, = | 
| Laporan Real-Time | DeviceKategori | String | SEPERTI, = | 
| Laporan Real-Time | eventName | String | SEPERTI, = | 
| Laporan Real-Time | MinuteSago | String | SEPERTI, = | 
| Laporan Real-Time | platform | String | SEPERTI, = | 
| Laporan Real-Time | streamId | String | SEPERTI, = | 
| Laporan Real-Time | StreamName | String | SEPERTI, = | 
| Laporan Real-Time | unifiedScreenName | String | SEPERTI, = | 
| Laporan Real-Time | ActiveUsers | String | >, <, >=, <=, = ANTARA | 
| Laporan Real-Time | konversi | String | >, <, >=, <=, = ANTARA | 
| Laporan Real-Time | EventCount | String | >, <, >=, <=, = ANTARA | 
| Laporan Real-Time | screenPageViews | String | >, <, >=, <=, = ANTARA | 

 **Mempartisi kueri** 

1.  **Partisi berbasis filter** 

    Opsi percikan tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, `NUM_PARTITIONS` dapat diberikan jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas percikan secara bersamaan. 
   +  `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri. 
   +  `LOWER_BOUND`: nilai batas bawah inklusif dari bidang partisi yang dipilih. 

      Untuk tanggal, kami menerima format tanggal Spark yang digunakan dalam kueri Spark SQL. Contoh nilai yang valid:`"2024-02-06"`. 
   +  `UPPER_BOUND`: nilai batas atas eksklusif dari bidang partisi yang dipilih. 
   +  `NUM_PARTITIONS`: jumlah partisi. 

    **Contoh** 

   ```
   googleAnalytics4_read = glueContext.create_dynamic_frame.from_options(
       connection_type="GoogleAnalytics4",
       connection_options={
           "connectionName": "connectionName",
           "ENTITY_NAME": "entityName",
           "API_VERSION": "v1beta",
           "PARTITION_FIELD": "date"
           "LOWER_BOUND": "2022-01-01"
           "UPPER_BOUND": "2024-01-02"
           "NUM_PARTITIONS": "10"
       }
   ```

1.  **Partisi berbasis rekaman** 

    Opsi percikan tambahan `NUM_PARTITIONS` dapat diberikan jika Anda ingin memanfaatkan konkurensi di Spark. Dengan parameter ini, kueri asli akan dibagi menjadi `NUM_PARTITIONS` sejumlah sub-kueri yang dapat dijalankan oleh tugas percikan secara bersamaan. 
   +  `NUM_PARTITIONS`: jumlah partisi. 

    **Contoh** 

   ```
   googleAnalytics4_read = glueContext.create_dynamic_frame.from_options(
       connection_type="GoogleAnalytics4",
       connection_options={
           "connectionName": "connectionName",
           "ENTITY_NAME": "entityName",
           "API_VERSION": "v1beta",
           "NUM_PARTITIONS": "10"
       }
   ```