Jenis data dan jenis semantik

Saat Anda membuat konektor komunitas, setiap kolom yang Anda tentukan dalam skema memerlukan jenis data. Jenis data menentukan jenis primitif kolom seperti BOOLEAN, STRING, NUMBER, dll.

Selain jenis data, Looker Studio juga menggunakan jenis semantik. Jenis semantik membantu mendeskripsikan jenis informasi yang diwakili oleh data. Misalnya, kolom dengan jenis data NUMBER dapat secara semantik merepresentasikan jumlah mata uang atau persentase dan kolom dengan jenis data STRING dapat secara semantik merepresentasikan kota. Untuk melihat jenis semantik yang tersedia, lihat dokumentasi jenis semantik

Skema Konektor Komunitas dan kolom Looker Studio

Saat Anda menentukan skema untuk konektor komunitas, ada berbagai properti untuk setiap kolom yang akan menentukan cara kolom ditampilkan dan digunakan di Looker Studio. Contoh:

  • conceptType ditentukan dalam skema konektor Anda menggunakan properti conceptType. Properti ini menentukan apakah kolom diperlakukan sebagai dimensi atau metrik. Penjelasan tentang perbedaan antara metrik dan dimensi dapat ditemukan di Dimensi dan metrik.
  • Jenis semantik dapat ditentukan dalam skema konektor, atau dapat dideteksi secara otomatis oleh Looker Studio berdasarkan properti jenis data yang ditentukan dalam konektor dan nilai data yang ditampilkan oleh konektor Anda. Lihat Deteksi jenis semantik otomatis untuk mengetahui detail tentang cara kerjanya.
  • Jenis agregasi menentukan apakah nilai metrik (dimensi diabaikan) dapat diagregasikan ulang. Jika properti semantics.isReaggregatable ditetapkan ke true, agregasi defaultnya adalah SUM, jika tidak, agregasinya ditetapkan ke Auto. Anda juga dapat menetapkan jenis agregasi default secara manual untuk kolom yang dapat diagregasi ulang menggunakan properti defaultAggregationType.

Saat Anda mengonfigurasi dan menghubungkan menggunakan konektor di Looker Studio, editor kolom akan menampilkan skema lengkap untuk konektor berdasarkan cara Anda menentukan properti di atas. Jika Anda telah menyertakan jenis semantik, jenis tersebut akan ditampilkan sesuai dengan yang telah Anda tentukan. Jika Anda menggunakan deteksi jenis semantik otomatis, maka kolom akan ditampilkan seperti yang terdeteksi. Layar Fields

Menetapkan informasi semantik

Ada dua cara untuk menyetel informasi semantik. Anda dapat menetapkan semantik kolom secara manual atau mengandalkan Looker Studio untuk mendeteksi secara otomatis.

Misalnya, jika Anda memiliki Angka yang secara semantik merepresentasikan Dolar AS, Looker Studio tidak akan dapat mendeteksi jenis semantik ini secara otomatis. Selain itu, deteksi semantik otomatis mengharuskan Looker Studio melakukan panggilan pengambilan data untuk setiap kolom skema Anda. Jika Anda menentukan skema secara manual, panggilan pengambilan data tidak akan dilakukan. Jika Anda mengetahui jenis semantik (misalnya, mata uang, persen, tanggal, dll.) untuk data Anda, sebaiknya tetapkan jenis semantik ini secara eksplisit dalam skema untuk alasan akurasi dan performa.

Menetapkan jenis semantik secara manual (Direkomendasikan)

Jika mengetahui jenis semantik, Anda dapat menentukan semantics secara manual untuk setiap kolom skema. Detail lengkap tentang properti yang tersedia untuk Anda dapat ditemukan di halaman referensi kolom. Jika Anda memilih untuk menentukan jenis semantik manual, sebaiknya tentukan semanticType dan semanticGroup untuk setiap kolom. Dengan memberikan properti ini secara manual, proses deteksi jenis semantik otomatis tidak akan berjalan. Jika Anda menetapkan beberapa kolom secara manual, tetapi tidak semuanya, kolom yang tidak Anda tentukan akan ditetapkan secara default ke Text, Number, atau Boolean, bergantung pada dataType yang ditentukan untuk kolom tersebut.

Berikut adalah contoh skema sederhana yang menetapkan jenis semantik secara manual. Income ditetapkan sebagai Mata Uang, dan Filing Year ditetapkan sebagai tanggal.

data-studio/semantics.gs
var schema = [
  {
    'name': 'Income',
    'label': 'Income (in USD)',
    'dataType': 'NUMBER',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'CURRENCY',
      'semanticType': 'CURRENCY_USD'
    }
  }, {
    'name': 'Filing Year',
    'label': 'Year in which you filed the taxes.',
    'dataType': 'STRING',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'DATE_OR_TIME',
      'semanticType': 'YEAR'
    }
  }
];

Memecahkan Masalah Jenis Semantik Manual

Jika Anda menetapkan jenis semantik yang salah untuk data pokok, jenis semantik tersebut tidak akan berfungsi dengan baik. Hal ini mungkin sulit diuji, tetapi ada beberapa hal yang dapat Anda lakukan untuk membantu menemukan masalah.

  1. Tampilkan 2 atau 3 baris dari data Anda, bukan semuanya, lalu periksa secara manual.
  2. Buat tabel di Looker Studio yang hanya menggunakan kolom yang ingin Anda periksa.
  3. Perhatikan kolom Geo dan Date karena kolom ini memiliki format yang paling ketat.

Deteksi jenis semantik otomatis

Jika Anda belum menentukan jenis semantik apa pun dalam skema, Looker Studio akan mencoba mendeteksinya secara otomatis berdasarkan properti jenis data dan format nilai data yang ditampilkan oleh konektor Anda.

Langkah-langkah proses deteksi otomatis adalah sebagai berikut:

  1. Minta skema dengan menjalankan fungsi getSchema dari konektor komunitas Anda.
  2. Lakukan iterasi pada batch kolom yang ditentukan dalam skema konektor dan kirimkan permintaan getData untuk kolom tersebut. Permintaan getData dieksekusi dengan parameter sampleExtraction disetel ke true untuk menunjukkan bahwa permintaan data ditujukan untuk tujuan deteksi semantik.
  3. Berdasarkan jenis data kolom dan format nilai yang ditampilkan dari permintaan getData, identifikasi jenis semantik kolom.

Opsi untuk menangani deteksi jenis semantik otomatis

Saat Looker Studio menjalankan fungsi getData dari konektor komunitas untuk tujuan deteksi semantik, permintaan yang masuk akan berisi properti sampleExtraction yang akan disetel ke true. Data yang ditampilkan oleh konektor Anda hanya digunakan oleh Looker Studio untuk mengidentifikasi jenis semantik kolom. Karena nilai tidak akan digunakan untuk tujuan lain, nilai tersebut tidak memerlukan data sebenarnya dari sumber eksternal Anda.

Ada beberapa cara untuk meningkatkan deteksi jenis semantik dalam kode Anda:

  • Direkomendasikan: Teruskan nilai yang telah ditentukan sebelumnya
    Menampilkan nilai yang telah ditentukan sebelumnya untuk setiap kolom yang paling mewakili jenis semantik untuk kolom tersebut dan diketahui terdeteksi dengan benar oleh Looker Studio. Misalnya, jika jenis semantik untuk kolom adalah Negara, maka tampilkan nilai seperti IT untuk Italia. Manfaat lain dari pendekatan ini adalah jauh lebih cepat karena Anda tidak perlu membuat permintaan HTTP ke layanan pihak ketiga untuk mendapatkan data.

  • Hanya menampilkan n jumlah data
    Jika layanan pihak ketiga tempat Anda mengambil data mendukung batas baris saat meminta data, tampilkan subkumpulan kecil baris ke Looker Studio, bukan set data lengkap. Tindakan ini akan membatasi jumlah data yang perlu Anda teruskan ke Looker Studio untuk setiap permintaan deteksi semantik.

  • Meminta semua kolom dan menyimpan respons dalam cache
    Jika memungkinkan untuk meminta semua kolom untuk layanan pihak ketiga tempat Anda mengambil data, maka pada permintaan deteksi semantik pertama yang diterima dari Looker Studio, ambil semua kolom dan simpan hasilnya dalam cache. Untuk permintaan deteksi semantik berikutnya, nilai kolom diambil dari cache daripada membuat permintaan HTTP tambahan ke layanan pihak ketiga.

  • Tidak melakukan apa pun yang berbeda
    Anda dapat memilih untuk tidak menerapkan akomodasi tertentu untuk permintaan yang sampleExtraction-nya ditetapkan ke true. Hal ini akan menyebabkan proses Deteksi Semantik menjadi lebih lambat karena Looker Studio harus mengambil semua data untuk proses Deteksi Semantik. Selain itu, hal ini akan memengaruhi kecepatan permintaan ke sumber data eksternal Anda karena banyak permintaan deteksi semantik akan dieksekusi secara paralel.

Format yang dikenali untuk deteksi jenis semantik otomatis

Tanggal & Waktu
  • YYYY/MM/DD-HH:MM:SS
  • YYYY-MM-DD [HH:MM:SS[.uuuuuu]]
  • YYYY/MM/DD [HH:MM:SS[.uuuuuu]]
  • YYYYMMDD [HH:MM:SS[.uuuuuu]]
  • Sat, 24 May 2008 20:09:47 GMT
  • 2008-05-24T20:09:47Z
  • Waktu: epoch untuk detik, mikro, mili, dan nano.
Geo