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
<a name="analysis-rules-id-mapping-table"></a>

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 dalam JOIN pernyataan.

  AWS Clean Rooms memungkinkanINNER,LEFT, atau RIGHT bergabung pada tabel pemetaan ID jika menghormati tumpang tindih. Untuk melindungi informasi pemetaan sensitif, tabel pemetaan ID harus selalu berada di sisi "inner" dari operasi apa punJOIN. Misalnya, JOIN operasi berikut ini valid:
  + table LEFT JOIN id\$1mapping\$1table
  + id\$1mapping\$1table RIGHT JOIN table
  + table INNER JOIN id\$1mapping\$1table

  JOINOperasi berikut tidak valid:
  + id\$1mapping\$1table LEFT JOIN table
  + table RIGHT JOIN id\$1mapping\$1table

  Ini mencegah eksposur catatan pemetaan yang tidak memiliki kecocokan yang sesuai dalam kumpulan data Anda. Mengizinkan operasi semacam itu berpotensi mengungkapkan informasi sensitif tentang pemetaan data anggota kolaborasi lainnya.
+ Gunakan kolom tabel pemetaan dalam JOIN pernyataan. 

  Anda tidak dapat menggunakan kolom tabel pemetaan dalam pernyataan berikut:SELECT,,, WHERE HAVINGGROUP BY, atau ORDER BY (kecuali perlindungan diubah pada asosiasi namespace ID sumber atau asosiasi namespace ID target).
+ Dalam SQL diperluas, AWS Clean Rooms juga mendukung, implisit OUTER JOINJOIN, dan CROSS. JOIN Penggabungan 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](#id-mapping-table-query-controls)

Parameter aturan analisis, didefinisikan dalam[Kontrol kueri aturan analisis tabel pemetaan ID](#parameters-id-mapping-query-controls), termasuk kontrol kueri dan kontrol hasil kueri. Kontrol kuerinya mencakup kemampuan untuk memerlukan tumpang tindih tabel pemetaan ID dalam JOIN pernyataan (yaitu,`requireOverlap`).

**Topics**
+ [Struktur kueri tabel pemetaan ID dan sintaks](#id-mapping-table-query-controls)
+ [Kontrol kueri aturan analisis tabel pemetaan ID](#parameters-id-mapping-query-controls)
+ [Aturan analisis tabel pemetaan ID struktur yang telah ditentukan](#id-mapping-table-predefined-structure)
+ [Aturan analisis tabel pemetaan ID - contoh](#id-mapping-table-example)

## Struktur kueri tabel pemetaan ID dan sintaks
<a name="id-mapping-table-query-controls"></a>

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
<a name="collab-table-structure"></a>

Tabel berikut mewakili tabel dikonfigurasi yang ada dalam AWS Clean Rooms kolaborasi. Kolom **id** di tabel **cr\$1drivers\$1license dan **cr\$1insurance**** mewakili kolom yang cocok dengan tabel pemetaan ID.

**cr\$1drivers\$1license**


|  |  |  | 
| --- |--- |--- |
| id | driver\$1name | state\$1of\$1registrasi | 
| 1 | Eduard | TX | 
| 2 | Dana | MA | 
| 3 | Gweneth | IL | 

**cr\$1asuransi**


|  |  |  | 
| --- |--- |--- |
| id | pemegang kebijakan\$1email | policy\$1number | 
| 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
<a name="id-mapping-table-structure"></a>

**Tabel berikut merupakan tabel pemetaan ID yang ada yang cocok pada tabel **cr\$1drivers\$1license dan cr\$1insurance**.** Tidak semua entri akan dimiliki IDs untuk kedua tabel kolaborasi.


|  |  | 
| --- |--- |
| cr\$1drivers\$1license\$1id | cr\$1insurance\$1id | 
| 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\$1drivers\$1license\$1id | cr\$1insurance\$1id | driver\$1name | state\$1of\$1registrasi | pemegang kebijakan\$1email | policy\$1number | 
| 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
<a name="id-mapping-table-example-queries"></a>

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 ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id
    [ INNER | 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 ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id
        [ INNER | 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 ] JOIN cr_identity_mapping_table idmt ON idmt.cr_drivers_license_id = cr_dl.id
            [ INNER | RIGHT ] JOIN cr_insurance cr_in            ON idmt.cr_insurance_id       = cr_in.id
    )SELECT
    [ select_items ]FROM
    matched_ids
;
```

### Pertimbangan-pertimbangan
<a name="id-mapping-table-considerations"></a>

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` atau`targetID`) dapat diizinkan di mana saja dalam kueri. Untuk informasi selengkapnya, lihat [Ruang nama ID di AWS Clean Rooms](working-with-id-namespaces.md).
+ Aturan analisis tabel pemetaan ID mewarisi batasan SQL dari aturan analisis lainnya dalam kolaborasi.

## Kontrol kueri aturan analisis tabel pemetaan ID
<a name="parameters-id-mapping-query-controls"></a>

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 mengizinkan`sourceID`,`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](analysis-rules-aggregation.md#join-controls). | 
| dimensionColumns  | Kolom (jika ada) yang dapat digunakan anggota yang dapat kueri dalam pernyataan SELECT dan GROUP BY.  |  A `dimensionColumn` dapat digunakan di SELECT dan GROUPBY. A `dimensionColumn` dapat muncul sebagai`joinKeys`.  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
<a name="id-mapping-table-predefined-structure"></a>

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. `sourceID`Dan `targetID` harus digunakan dalam JOIN ketika tabel pemetaan ID direferensikan.
+ Hanya `targetID` dilindungi

  Dalam konfigurasi ini, tidak `targetID` dapat diproyeksikan. `targetID`Harus digunakan dalam JOIN ketika tabel pemetaan ID direferensikan. Ini `sourceID` dapat digunakan dalam kueri.
+ Hanya `sourceID` dilindungi

  Dalam konfigurasi ini, tidak `sourceID` dapat diproyeksikan. `sourceID`Harus digunakan dalam JOIN ketika tabel pemetaan ID direferensikan. Ini `targetID` dapat digunakan dalam kueri.
+ 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
<a name="id-mapping-table-example"></a>

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.

1. 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.

1. 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 

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

1. 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
   ```