Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Menghubungkan ke Smartsheet
Smartsheet adalah produk SaaS manajemen kerja dan kolaborasi. Pada dasarnya, Smartsheet memungkinkan pengguna untuk menggunakan objek seperti spreadsheet untuk membuat, menyimpan, dan memanfaatkan data bisnis.
**Topics**
+ [AWS Glue dukungan untuk Smartsheet](smartsheet-support.md)
+ [Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi](smartsheet-configuring-iam-permissions.md)
+ [Mengkonfigurasi Smartsheet](smartsheet-configuring.md)
+ [Mengkonfigurasi koneksi Smartsheet](smartsheet-configuring-connections.md)
+ [Membaca dari entitas Smartsheet](smartsheet-reading-from-entities.md)
+ [Opsi koneksi Smartsheet](smartsheet-connection-options.md)
+ [Membuat akun Smartsheet](smartsheet-create-account.md)
+ [Batasan](smartsheet-connector-limitations.md)
# AWS Glue dukungan untuk Smartsheet
AWS Glue mendukung Smartsheet sebagai berikut:
**Didukung sebagai sumber?**
Ya. Anda dapat menggunakan pekerjaan AWS Glue ETL untuk menanyakan data dari Smartsheet.
**Didukung sebagai target?**
Tidak.
**Versi Smartsheet API yang didukung**
v2.0
# Kebijakan yang berisi operasi API untuk membuat dan menggunakan koneksi
Kebijakan contoh berikut menjelaskan AWS izin yang diperlukan untuk membuat dan menggunakan koneksi. Jika Anda membuat peran baru, buat kebijakan yang berisi hal-hal berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Jika Anda tidak ingin menggunakan metode sebelumnya, sebagai alternatif, gunakan kebijakan IAM terkelola berikut:
+ [ AWSGlueServiceRole ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Memberikan akses ke sumber daya yang diperlukan berbagai AWS Glue proses untuk dijalankan atas nama Anda. Sumber daya ini termasuk AWS Glue, Amazon S3, IAM, CloudWatch Log, dan Amazon EC2. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, AWS Glue proses memiliki izin yang diperlukan. Kebijakan ini biasanya dilampirkan pada peran yang ditentukan saat menentukan crawler, tugas, dan titik akhir pengembangan.
+ [ AWSGlueConsoleFullAccess ](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Memberikan akses penuh ke AWS Glue sumber daya ketika identitas yang dilampirkan kebijakan menggunakan konsol AWS Manajemen. Jika Anda mengikuti konvensi penamaan untuk sumber daya yang ditentukan dalam kebijakan ini, maka pengguna memiliki kemampuan konsol penuh. Kebijakan ini biasanya dilampirkan ke pengguna AWS Glue konsol.
# Mengkonfigurasi Smartsheet
Sebelum Anda dapat menggunakan AWS Glue untuk mentransfer dari Smartsheet, Anda harus memenuhi persyaratan berikut:
## Persyaratan minimum
+ Anda memiliki akun Smartsheet dengan email dan kata sandi. Untuk informasi selengkapnya tentang membuat akun, lihat [Membuat akun Smartsheet](smartsheet-create-account.md).
+ Akun Smartsheet Anda memiliki akses API dengan lisensi yang valid.
+ Akun Smartsheet Anda memiliki paket **harga Pro untuk `Sheets` entitas dan paket harga** Perusahaan dengan Add-On Pelaporan Acara untuk `Events` entitas.
Jika memenuhi persyaratan ini, Anda siap untuk terhubung AWS Glue ke akun Smartsheet Anda. Untuk koneksi biasa, Anda tidak perlu melakukan hal lain di Smartsheet.
# Mengkonfigurasi koneksi Smartsheet
Smartsheet mendukung jenis `AUTHORIZATION_CODE` hibah untuk OAuth2.
Jenis hibah ini dianggap “berkaki tiga” `OAuth` karena bergantung pada pengalihan pengguna ke server otorisasi pihak ketiga untuk mengautentikasi pengguna. Pengguna dapat memilih untuk membuat aplikasi mereka sendiri yang terhubung di Smartsheet dan memberikan ID klien dan rahasia klien mereka sendiri saat membuat koneksi melalui AWS Glue konsol. Dalam skenario ini, mereka masih akan diarahkan ke Smartsheet untuk masuk dan mengotorisasi AWS Glue untuk mengakses sumber daya mereka.
Jenis hibah ini menghasilkan token penyegaran dan token akses. Token akses berumur pendek, dan dapat disegarkan secara otomatis tanpa interaksi pengguna menggunakan token penyegaran.
[Untuk dokumentasi Smartsheet publik tentang cara membuat aplikasi yang terhubung untuk alur AUTHORIZATION\$1CODE OAuth , lihat Smartsheet. APIs](https://smartsheet.redoc.ly/#section/OAuth-Walkthrough)
Untuk mengonfigurasi koneksi Smartsheet:
1. Di AWS Secrets Manager, buat rahasia dengan detail berikut:
Untuk aplikasi terhubung yang dikelola pelanggan — Rahasia harus berisi aplikasi yang terhubung Rahasia Konsumen dengan kunci `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` sebagai.
**catatan**
Ini adalah suatu keharusan untuk membuat rahasia per koneksi di AWS Glue.
1. Dalam AWS Glue Studio, buat koneksi di bawah **Koneksi Data** dengan mengikuti langkah-langkah di bawah ini:
1. Saat memilih **jenis Koneksi**, pilih Smartsheet.
1. Berikan Smartsheet yang ingin Anda sambungkan. `instanceUrl`
1. Pilih peran IAM yang AWS Glue dapat diasumsikan dan memiliki izin untuk tindakan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Pilih `secretName` yang ingin Anda gunakan untuk koneksi ini AWS Glue untuk memasukkan token.
1. Pilih opsi jaringan jika Anda ingin menggunakan jaringan Anda.
1. Berikan peran IAM yang terkait dengan izin AWS Glue pekerjaan Anda untuk membaca`secretName`.
# Membaca dari entitas Smartsheet
**Prasyarat**
`Smartsheet`Objek 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 \$1 | Mendukung Partisi |
| --- | --- | --- | --- | --- | --- |
| Lembar Daftar | Ya | Ya | Tidak | Ya | Tidak |
| Metadata Baris | Ya | Ya | Tidak | Ya | Tidak |
| Lembar Metadata | Tidak | Tidak | Tidak | Ya | Tidak |
| Lembar Data | Ya | Ya | Ya | Ya | Tidak |
| Peristiwa | Ya | Ya | Tidak | Ya | Tidak |
**Contoh**
```
Smartsheet_read = glueContext.create_dynamic_frame.from_options(
connection_type="smartsheet",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "list-sheets",
"API_VERSION": "2.0",
"INSTANCE_URL": "https://api.smartsheet.com"
})
```
**Entitas Smartsheet dan detail bidang**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/glue/latest/dg/smartsheet-reading-from-entities.html)
**Entitas dengan metadata dinamis:**
Untuk entitas berikut, Smartsheet menyediakan titik akhir untuk mengambil metadata secara dinamis, memungkinkan dukungan operator ditangkap pada tingkat tipe data.
| Entitas | Tipe data | Operator yang Didukung |
| --- | --- | --- |
| Lembar Data | String | TA |
| Lembar Data | Panjang | "=" |
| Lembar Data | Bilangan Bulat | TA |
| Lembar Data | DateTime | > |
**Contoh**
```
Smartsheet_read = glueContext.create_dynamic_frame.from_options(
connection_type="smartsheet",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "list-sheets",
"API_VERSION": "2.0",
"INSTANCE_URL": "https://api.smartsheet.com"
}
```
# Opsi koneksi Smartsheet
Berikut ini adalah opsi koneksi untuk Smartsheet:
+ `ENTITY_NAME`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Nama Object Anda di Smartsheet.
+ `API_VERSION`(String) - (Diperlukan) Digunakan untuk Baca/Tulis. Versi Smartsheet Rest API yang ingin Anda gunakan. Misalnya: v2.0.
+ `INSTANCE_URL`(String) - (Diperlukan) Digunakan untuk Baca. URL contoh Smartsheet.
+ `SELECTED_FIELDS`(Daftar) — Default: kosong (SELECT \$1). Digunakan untuk Baca. Kolom yang ingin Anda pilih untuk objek.
+ `FILTER_PREDICATE`(String) - Default: kosong. Digunakan untuk Baca. Itu harus dalam format Spark SQL.
+ `QUERY`(String) - Default: kosong. Digunakan untuk Baca. Kueri SQL Spark penuh.
# Membuat akun Smartsheet
1. Mendaftar untuk akun Smartsheet dengan mengakses halaman sing-up [Smartsheet](https://app.smartsheet.com/home).
1. Pilih **Buat satu** untuk membuat akun baru, atau masuk menggunakan akun Google, Microsoft, atau Apple yang terdaftar.
1. Masukkan alamat email kantor Anda saat diminta.
1. Pilih **Lanjutkan** dan jika diperlukan, verifikasi identitas Anda.
1. Buka email konfirmasi dari Smartsheet, dan pilih tautan konfirmasi untuk memverifikasi akun Anda.
Anda akan berlangganan Paket Uji Coba secara default.
1. Di sudut kiri bawah, pilih ikon **Akun** dan pilih **Tambahkan Lisensi/Peningkatan** untuk meningkatkan paket harga Anda.
**catatan**
Ini diperlukan untuk mengakses **Event Reporting**, yang merupakan add-on dalam paket **Enterprise**.
1. Di bawah paket **Enterprise**, pilih **Hubungi Kami** untuk meminta peningkatan akun dari tim dukungan.
1. Dalam formulir permintaan dukungan, berikan detail yang diperlukan dan persyaratan Anda untuk meningkatkan paket.
Ini melengkapi upgrade ke paket **Enterprise**.
**Membuat `OAuth2.0` kredensi**
1. Setelah memutakhirkan paket harga akun Anda untuk mendapatkan akses ke **Alat Pengembang**, akses pengembang [Smartsheet](https://developers.smartsheet.com/).
Anda akan menerima email aktivasi.
1. Buka email aktivasi dari Smartsheet, dan pilih tautan aktivasi untuk mengaktifkan alat pengembang di akun Anda.
Alat pengembang memungkinkan Anda membuat aplikasi.
1. Buka halaman beranda akun Smartsheet Anda dan pilih **Akun** untuk memeriksa akses.
1. Pilih **Alat Pengembang** dari daftar layanan, dan masukkan detail **Profil Pengembang**.
1. Pilih **Buat Aplikasi Baru**.
1. Masukkan detail berikut ke dalam formulir pendaftaran aplikasi:
+ **Nama** — Nama aplikasi.
+ **Deskripsi** — Deskripsi aplikasi.
+ **URL** — URL yang memungkinkan Anda meluncurkan aplikasi atau URL halaman landing.
+ **Kontak/dukungan** - Informasi kontak untuk tim dukungan.
+ URL **Redirect — URL** (juga dikenal sebagai URL callback) dalam aplikasi Anda yang akan menerima kredensi [OAuth 2.0](https://.console.aws.amazon.com/appflow/oauth).
1. Pilih **Simpan**.
Smartsheet menetapkan ID klien dan rahasia klien ke aplikasi Anda. Catat nilai-nilai ini untuk langkah selanjutnya. Anda juga dapat mencarinya lagi nanti di bagian **Alat Pengembang**.
# Batasan
Smartsheet tidak mendukung partisi berbasis lapangan atau berbasis rekaman.