Aturan analisis tabel pemetaan ID - AWS Clean Rooms

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

Aturan analisis tabel pemetaan ID

Dalam AWS Clean Rooms, aturan analisis tabel pemetaan ID bukanlah aturan analisis mandiri. Jenis aturan analisis ini dikelola oleh AWS Clean Rooms dan digunakan untuk menggabungkan data identitas yang berbeda untuk memfasilitasi kueri. Ini secara otomatis ditambahkan ke tabel pemetaan ID dan tidak dapat diedit. Ini mewarisi perilaku aturan analisis lain dalam kolaborasi — selama aturan analisis tersebut homogen.

Aturan analisis tabel pemetaan ID memberlakukan keamanan pada tabel pemetaan ID. Ini membatasi anggota kolaborasi dari langsung memilih atau memeriksa populasi yang tidak tumpang tindih antara kumpulan data kedua anggota menggunakan tabel pemetaan ID. Aturan analisis tabel pemetaan ID digunakan untuk melindungi data sensitif dalam tabel pemetaan ID saat digunakan dalam kueri dengan aturan analisis lainnya secara implisit.

Dengan aturan analisis tabel pemetaan ID, AWS Clean Rooms memberlakukan tumpang tindih di kedua sisi tabel pemetaan ID di SQL yang diperluas. Ini memungkinkan Anda untuk melakukan tugas-tugas berikut:

  • Gunakan tumpang tindih tabel pemetaan ID di JOIN pernyataan.

    AWS Clean Rooms memungkinkan sebuah INNER, LEFT, atau RIGHT bergabung di tabel pemetaan ID jika menghormati tumpang tindih.

  • Gunakan kolom tabel pemetaan di JOIN pernyataan.

    Anda tidak dapat menggunakan kolom tabel pemetaan dalam pernyataan berikut: SELECT, WHERE, HAVING, GROUP BY, atau ORDER BY (kecuali perlindungan dimodifikasi pada asosiasi namespace ID sumber atau asosiasi namespace ID target).

  • Dalam SQL diperluas, AWS Clean Rooms juga mendukung OUTER JOIN, implisit JOIN, dan CROSS JOIN. Gabungan ini tidak dapat memenuhi persyaratan tumpang tindih. Sebagai gantinya, AWS Clean Rooms gunakan requireOverlap untuk menentukan kolom mana yang harus digabungkan.

Struktur kueri dan sintaks yang didukung didefinisikan dalam. Struktur kueri tabel pemetaan ID dan sintaks

Parameter aturan analisis, didefinisikan dalamKontrol kueri aturan analisis tabel pemetaan ID, termasuk kontrol kueri dan kontrol hasil kueri. Kontrol kuerinya mencakup kemampuan untuk memerlukan tumpang tindih tabel pemetaan ID di JOIN pernyataan (yaitu,requireOverlap).

Struktur kueri tabel pemetaan ID dan sintaks

Kueri pada tabel yang memiliki aturan analisis tabel pemetaan ID harus mematuhi sintaks berikut.

--select_list_expression SELECT provider.data_col, consumer.data_col --table_expression FROM provider JOIN idMappingTable idmt ON provider.id = idmt.sourceId JOIN consumer ON consumer.id = idmt.targetId

Tabel kolaborasi

Tabel berikut mewakili tabel dikonfigurasi yang ada dalam AWS Clean Rooms kolaborasi. Kolom id di tabel cr_drivers_license dan cr_insurance mewakili kolom yang cocok dengan tabel pemetaan ID.

cr_drivers_license

id driver_name state_of_registrasi
1 Eduard TX
2 Dana MA
3 Gweneth IL

cr_asuransi

id pemegang kebijakan_email policy_number
a eduardo@internal.company.com 17f9d04e-f5be-4426-bdc4-250ed59c6529
b gwen@internal.company.com 3f0092db-2316-48a8-8d44-09cf8f6e6c64
c rosa@internal.company.com d7692e84-3d3c-47b8-b46d-a0d5345f0601

Tabel pemetaan ID

Tabel berikut merupakan tabel pemetaan ID yang ada yang cocok pada tabel cr_drivers_license dan cr_insurance. Tidak semua entri akan dimiliki IDs untuk kedua tabel kolaborasi.

cr_drivers_license_id cr_insurance_id
1 a
2 null
3 b
null c

Aturan analisis tabel pemetaan ID hanya memungkinkan kueri berjalan pada kumpulan data yang tumpang tindih, yang akan terlihat sebagai berikut:

cr_drivers_license_id cr_insurance_id driver_name state_of_registrasi pemegang kebijakan_email policy_number
1 a Eduard TX eduardo@internal.company.com 17f9d04e-f5be-4426-bdc4-250ed59c6529
3 b Gweneth IL gwen@internal.company.com 3f0092db-2316-48a8-8d44-09cf8f6e6c64

Kueri contoh

Contoh berikut menunjukkan lokasi yang valid untuk bergabung dengan tabel pemetaan ID:

-- Single ID mapping table SELECT [ select_items ] FROM cr_drivers_license cr_dl [ INNER | LEFT | RIGHT ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id [ INNER | LEFT | RIGHT ] JOIN cr_insurance cr_in ON idmt.cr_insurance_id = cr_in.id ; -- Single ID mapping table (Subquery) SELECT [ select_items ] FROM ( SELECT [ select_items ] FROM cr_drivers_license cr_dl [ INNER | LEFT | RIGHT ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id [ INNER | LEFT | RIGHT ] JOIN cr_insurance cr_in ON idmt.cr_insurance_id = cr_in.id ) ; -- Single ID mapping table (CTE) WITH matched_ids AS ( SELECT [ select_items ] FROM cr_drivers_license cr_dl [ INNER | LEFT | RIGHT ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id [ INNER | LEFT | RIGHT ] JOIN cr_insurance cr_in ON idmt.cr_insurance_id = cr_in.id ) SELECT [ select_items ] FROM matched_ids ;

Pertimbangan

Untuk struktur kueri tabel pemetaan ID dan sintaks, perhatikan hal berikut:

  • Anda tidak dapat mengeditnya.

  • Ini diterapkan ke tabel pemetaan ID secara default.

  • Ini menggunakan asosiasi namespace ID sumber dan target di dalam kolaborasi.

  • Tabel pemetaan ID dikonfigurasi secara default untuk memberikan perlindungan default untuk kolom yang berasal dari namepsace ID. Anda dapat memodifikasi konfigurasi ini sehingga kolom yang berasal dari namespace ID (salah satu sourceID atautargetID) dapat diizinkan di mana saja dalam kueri. Untuk informasi selengkapnya, lihat Ruang nama ID di AWS Clean Rooms.

  • Aturan analisis tabel pemetaan ID mewarisi batasan SQL dari aturan analisis lainnya dalam kolaborasi.

Kontrol kueri aturan analisis tabel pemetaan ID

Dengan kontrol kueri tabel pemetaan ID, AWS Clean Rooms mengontrol bagaimana kolom dalam tabel Anda digunakan untuk menanyakan tabel. Misalnya, ia mengontrol kolom mana yang digunakan untuk bergabung, dan kolom mana yang memerlukan tumpang tindih. Aturan analisis tabel pemetaan ID juga mencakup fungsionalitas yang memungkinkan Anda mengizinkansourceID,targetID, atau keduanya, diproyeksikan tanpa memerlukan JOIN.

Tabel berikut menjelaskan setiap kontrol.

Kontrol Definisi Penggunaan
joinColumns Kolom yang dapat digunakan anggota yang dapat kueri dalam pernyataan INNER JOIN. Anda tidak dapat menggunakan joinColumns di bagian lain dari kueri selain INNER JOIN.

Untuk informasi selengkapnya, lihat Bergabunglah dengan kontrol.

dimensionColumns Kolom (jika ada) yang dapat digunakan anggota yang dapat kueri dalam pernyataan SELECT dan GROUP BY.

A dimensionColumn dapat digunakan di SELECT and GROUP BY.

A dimensionColumn dapat muncul sebagaijoinKeys.

Anda hanya dapat menggunakan dimensionColumns dalam klausa JOIN jika Anda menentukannya dalam tanda kurung.

queryContraints:RequireOverlap

Kolom dalam tabel pemetaan ID yang harus digabungkan sehingga kueri dapat berjalan.

Kolom ini harus digunakan untuk BERGABUNG dengan tabel Pemetaan ID dan tabel kolaborasi.

Aturan analisis tabel pemetaan ID struktur yang telah ditentukan

Struktur yang ditentukan sebelumnya untuk aturan analisis tabel pemetaan ID dilengkapi dengan perlindungan default yang diterapkan pada dan. sourceID targetID Ini berarti bahwa kolom dengan perlindungan yang diterapkan harus digunakan dalam kueri.

Anda dapat mengonfigurasi aturan analisis tabel pemetaan ID dengan cara berikut:

  • Keduanya sourceID dan targetID dilindungi

    Dalam konfigurasi ini, sourceID dan keduanya tidak targetID dapat diproyeksikan. sourceIDDan targetID harus digunakan dalam JOIN ketika tabel pemetaan ID direferensikan.

  • Hanya targetID dilindungi

    Dalam konfigurasi ini, tidak targetID dapat diproyeksikan. targetIDHarus digunakan dalam JOIN ketika tabel pemetaan ID direferensikan. sourceIDDapat digunakan dalam query.

  • Hanya sourceID dilindungi

    Dalam konfigurasi ini, tidak sourceID dapat diproyeksikan. sourceIDHarus digunakan dalam JOIN ketika tabel pemetaan ID direferensikan. targetIDDapat digunakan dalam query.

  • Tidak ada sourceID atau targetID dilindungi

    Dalam konfigurasi ini, tabel pemetaan ID tidak tunduk pada penegakan khusus apa pun yang dapat digunakan dalam kueri.

Contoh berikut menunjukkan struktur yang telah ditentukan sebelumnya untuk aturan analisis tabel pemetaan ID dengan perlindungan default yang diterapkan pada dan. sourceID targetID Dalam contoh ini, aturan analisis tabel pemetaan ID hanya mengizinkan INNER JOIN pada sourceID kolom dan targetID kolom.

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [ "source_id", "target_id" ] } } ], "dimensionColumns": [] // columns that can be used in SELECT and JOIN }

Contoh berikut menunjukkan struktur yang telah ditentukan sebelumnya untuk aturan analisis tabel pemetaan ID dengan perlindungan yang diterapkan pada. targetID Dalam contoh ini, aturan analisis tabel pemetaan ID hanya mengizinkan INNER JOIN pada sourceID kolom.

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [ "target_id" ] } } ], "dimensionColumns": [ "source_id" ] }

Contoh berikut menunjukkan struktur yang telah ditentukan sebelumnya untuk aturan analisis tabel pemetaan ID dengan perlindungan yang diterapkan pada. sourceID Dalam contoh ini, aturan analisis tabel pemetaan ID hanya mengizinkan INNER JOIN pada targetID kolom.

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [ "source_id" ] } } ], "dimensionColumns": [ "target_id" ] }

Contoh berikut menunjukkan struktur yang ditentukan sebelumnya untuk aturan analisis tabel pemetaan ID tanpa perlindungan yang diterapkan pada or. sourceID targetID Dalam contoh ini, aturan analisis tabel pemetaan ID memungkinkan INNER JOIN pada sourceID kolom dan targetID kolom.

{ "joinColumns": [ "source_id", "target_id" ], "queryConstraints": [ { "requireOverlap": { "columns": [] } } ], "dimensionColumns": [ "source_id", "target_id" ] }

Aturan analisis tabel pemetaan ID - contoh

Daripada menulis pernyataan air terjun panjang yang merujuk Informasi Identifikasi Pribadi (PII), misalnya, perusahaan dapat menggunakan aturan analisis tabel pemetaan ID untuk menggunakan transcoding multi-pihak. LiveRamp Contoh berikut menunjukkan bagaimana Anda dapat berkolaborasi dalam AWS Clean Rooms menggunakan aturan analisis tabel pemetaan ID.

Perusahaan A adalah pengiklan yang memiliki data pelanggan dan penjualan, yang akan digunakan sebagai sumber. Perusahaan A juga melakukan transcoding atas nama para pihak dalam kolaborasi, dan membawa LiveRamp kredensialnya.

Perusahaan B adalah penerbit yang memiliki data peristiwa, yang akan digunakan sebagai target.

catatan

Baik Perusahaan A atau Perusahaan B dapat memberikan kredensi LiveRamp transcoding dan melakukan transcoding.

Untuk membuat kolaborasi yang memungkinkan analisis tabel pemetaan ID bekerja sama, perusahaan melakukan hal berikut:

  1. Perusahaan A menciptakan kolaborasi dan menciptakan keanggotaan. Ini menambahkan Perusahaan B, yang juga menciptakan keanggotaan dalam kolaborasi.

  2. Perusahaan A mengaitkan sumber namespace ID yang ada atau membuat yang baru dalam Resolusi Entitas AWS menggunakan konsol. AWS Clean Rooms

    Perusahaan A membuat tabel yang dikonfigurasi dengan data penjualannya dan kolom yang dikunci sourceId pada tabel pemetaan ID.

    Sumber namespace ID menyediakan data untuk transkode.

  3. Perusahaan B mengaitkan target namespace ID yang ada atau membuat yang baru dalam Resolusi Entitas AWS menggunakan konsol. AWS Clean Rooms

    Perusahaan B membuat tabel yang dikonfigurasi dengan data peristiwa mereka dan kolom yang dikunci ke targetId dalam tabel pemetaan ID.

    Target namespace ID tidak menyediakan data untuk ditranskode, hanya metadata di sekitar konfigurasi. LiveRamp

  4. Perusahaan A menemukan dua ruang nama ID yang terkait dengan kolaborasi dan membuat serta mengisi tabel pemetaan ID.

  5. Perusahaan A menjalankan kueri di dua kumpulan data dengan bergabung pada tabel pemetaan ID.

    --- this would be valid for Custom or List SELECT provider.data_col, consumer.data_col FROM provider JOIN idMappingTable-123123123123-myMappingWFName idmt ON provider.id = idmt.sourceId JOIN consumer ON consumer.id = idmt.targetId