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

# Membaca dari ServiceNow entitas
<a name="servicenow-reading-from-entities"></a>

**Prasyarat**

Objek ServiceNow Tabel yang ingin Anda baca. Anda akan memerlukan nama objek seperti pa\_bucket atau insiden.

**Contoh:**

```
servicenow_read = glueContext.create_dynamic_frame.from_options(
    connection_type="servicenow",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "pa_buckets",
        "API_VERSION": "v2"
        "instanceUrl": "https://<instance-name>.service-now.com"
    }
)
```

**ServiceNow detail entitas dan bidang**:

Untuk entitas berikut, ServiceNow sediakan titik akhir untuk mengambil metadata secara dinamis, sehingga dukungan operator ditangkap pada tingkat tipe data untuk setiap entitas.



- **Tabel (entitas dinamis)**
  - **Jenis data:** Bilangan Bulat / **Operator yang didukung:**  =,\! =, <, <=, >, >=, ANTARA
  - **Jenis data:** BigDecimal / **Operator yang didukung:**  =,\! =, <, <=, >, >=, ANTARA
  - **Jenis data:** Desimal / **Operator yang didukung:** =,\! =, <, <=, >, >=, ANTARA
  - **Jenis data:** Panjang / **Operator yang didukung:** =,\! =, <, <=, >, >=, ANTARA
  - **Jenis data:** Date / **Operator yang didukung:** =,\! =, <, <=, >, >=, ANTARA
  - **Jenis data:** DateTime / **Operator yang didukung:** =,\! =, <, <=, >, >=, ANTARA
  - **Jenis data:** Boolean / **Operator yang didukung:**  =, \!=
  - **Jenis data:** String / **Operator yang didukung:** =,\! =, <, <=, >, >=, ANTARA, SEPERTI
  - **Jenis data:** Struct / **Operator yang didukung:** N/A



**catatan**  
Tipe data Struct dikonversi ke tipe data String dalam respons konektor.

**catatan**  
`DML_STATUS`adalah atribut tambahan yang ditentukan pengguna yang digunakan untuk melacak CREATED/UPDATED catatan.

## Mempartisi kueri
<a name="servicenow-reading-partitioning-queries"></a>

**Partisi dasar lapangan**:

Anda dapat memberikan opsi Spark tambahan`PARTITION_FIELD`,, `LOWER_BOUND``UPPER_BOUND`, dan `NUM_PARTITIONS` 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 Spark secara bersamaan.



- **Entitas Dinamis**
  - **Bidang partisi:** sys\_mod\_count / **Jenis data:** Bilangan Bulat
  - **Bidang partisi:** sys\_created\_on, sys\_updated\_on / **Jenis data:** DateTime


+ `PARTITION_FIELD`: nama bidang yang akan digunakan untuk mempartisi kueri.
+ `LOWER_BOUND`: nilai batas bawah **inklusif** dari bidang partisi yang dipilih.

  Untuk bidang Datetime, kami menerima format stempel waktu Spark yang digunakan dalam kueri SQL. SPark 

  Contoh nilai valid:

  ```
  "2024-01-30T06:47:51.000Z"
  ```
+ `UPPER_BOUND`: nilai batas atas **eksklusif** dari bidang partisi yang dipilih.
+ `NUM_PARTITIONS`: jumlah partisi.

Tabel berikut menjelaskan rincian dukungan bidang partisi entitas:

Contoh:

```
servicenow_read = glueContext.create_dynamic_frame.from_options(
    connection_type="servicenow",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "pa_buckets",
        "API_VERSION": "v2",
        "instanceUrl": "https://<instance-name>.service-now.com"
        "PARTITION_FIELD": "sys_created_on"
        "LOWER_BOUND": "2024-01-30T06:47:51.000Z"
        "UPPER_BOUND": "2024-06-30T06:47:51.000Z"
        "NUM_PARTITIONS": "10"
    }
```

Partisi **berbasis rekaman**:

Anda dapat memberikan opsi Spark tambahan `NUM_PARTITIONS` jika Anda ingin menggunakan konkurensi di Spark. Dengan parameter ini, kueri asli dibagi menjadi `NUM_PARTITIONS` beberapa sub-kueri yang dapat dijalankan oleh tugas Spark secara bersamaan.

Dalam partisi berbasis rekaman, jumlah total catatan yang ada ditanyakan dari ServiceNow API, dan dibagi dengan nomor yang disediakan. `NUM_PARTITIONS` Jumlah catatan yang dihasilkan kemudian diambil secara bersamaan oleh setiap sub-kueri.
+ `NUM_PARTITIONS`: jumlah partisi.

Contoh:

```
servicenow_read = glueContext.create_dynamic_frame.from_options(
    connection_type="servicenow",
    connection_options={
        "connectionName": "connectionName",
        "ENTITY_NAME": "pa_buckets",
        "API_VERSION": "v2",
        "instanceUrl": "https://<instance-name>.service-now.com"
        "NUM_PARTITIONS": "2"
    }
```