

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

# Memulai konteks bisnis di Katalog Data
<a name="catalog-business-context-getting-started"></a>

**catatan**  
Konteks bisnis dan pencarian semantik dalam pratinjau AWS Glue dan dapat berubah sewaktu-waktu.

Tutorial ini memandu Anda melalui pembuatan glosarium, menandai aset, dan menggunakan pencarian semantik untuk menemukan data berdasarkan makna.

## Prasyarat
<a name="business-context-getting-started-prereqs"></a>
+  AWS Akun dengan Katalog AWS Glue Data yang dikonfigurasi di Wilayah yang didukung.
+ Yang AWS CLI diinstal dan dikonfigurasi.
+ Setidaknya satu tabel terdaftar di Katalog Data.
+ Peran IAM atau pengguna dengan izin untuk tindakan Katalog AWS Glue Data.

Lampirkan kebijakan IAM berikut untuk memberikan izin yang diperlukan:

```
{
    "Version": "2012-10-17",
    "Statement": [{
        "Effect": "Allow",
        "Action": [
            "glue:SearchAssets", "glue:PutAsset", "glue:GetAsset", "glue:DeleteAsset",
            "glue:PutAssetType", "glue:GetAssetType", "glue:DeleteAssetType", "glue:ListAssetTypes",
            "glue:CreateGlossary", "glue:UpdateGlossary", "glue:GetGlossary", "glue:ListGlossaries", "glue:DeleteGlossary",
            "glue:CreateGlossaryTerm", "glue:UpdateGlossaryTerm", "glue:GetGlossaryTerm", "glue:ListGlossaryTerms", "glue:DeleteGlossaryTerm",
            "glue:AssociateGlossaryTerms", "glue:DisassociateGlossaryTerms",
            "glue:PutFormType", "glue:GetFormType", "glue:DeleteFormType", "glue:ListFormTypes",
            "glue:PutAttachment", "glue:DeleteAttachment",
            "glue:ListIterableForms", "glue:BatchGetIterableForms"
        ],
        "Resource": "*"
    }]
}
```

## Langkah 1: Buat glosarium dan beri tag aset
<a name="business-context-step1-create-glossary"></a>

**Untuk membuat glosarium**  
Jalankan perintah berikut:

```
aws glue create-glossary \
  --name "Enterprise Data Glossary" \
  --description "Standardized business definitions for enterprise data assets."
```

Contoh keluaran:

```
{
    "Id": "d7xm3np5rk2w9j",
    "Name": "Enterprise Data Glossary"
}
```

**Untuk membuat istilah glosarium**  
Ganti pengidentifikasi glosarium dengan `Id` dari output sebelumnya.

```
aws glue create-glossary-term \
  --glossary-identifier "d7xm3np5rk2w9j" \
  --name "Active User" \
  --short-description "A user with at least one login in the last 30 days." \
  --long-description "An account that has logged in at least once within the trailing 30-day window."
```

Contoh output:

```
{
    "Id": "c2fymbu18rtsx5",
    "GlossaryId": "d7xm3np5rk2w9j",
    "Name": "Active User"
}
```

**Untuk mengaitkan istilah dengan aset**  
Jalankan perintah berikut:

```
aws glue associate-glossary-terms \
  --identifier "arn:aws:glue:us-east-1:123456789012:table/mydb/sales_transactions" \
  --glossary-term-identifiers "c2fymbu18rtsx5"
```

## Langkah 2: Cari data menggunakan konteks bisnis
<a name="business-context-step2-search"></a>

Gunakan `SearchAssets` API untuk menemukan aset berdasarkan arti bisnis.

```
aws glue search-assets \
  --search-text "active users"
```

Contoh output:

```
{
    "Items": [
        {"Id": "c9vq7sh2fk4t2h", "AssetName": "Customer Sales Transactions", "AssetTypeId": "Table"}
    ]
}
```

Untuk memfilter hasil berdasarkan jenis aset:

```
aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}}' \
  --max-results 10
```

Untuk memfilter hanya AWS Glue tabel (tidak termasuk tabel dari sistem sumber lain):

```
aws glue search-assets \
  --search-text "active users" \
  --filter-clause '{"AndAllFilters":[{"AttributeFilter":{"Attribute":"type","Operator":"equals","Value":{"StringValue":"Table"}}},{"AttributeFilter":{"Attribute":"namespace","Operator":"equals","Value":{"StringValue":"amazon.glue"}}}]}' \
  --max-results 10
```

## Menggunakan agen AI dengan katalog
<a name="business-context-getting-started-agent-toolkit"></a>

MCP-compatible Agen AI dapat menemukan aset katalog, mengambil konteks bisnis, dan memuat konten keterampilan menggunakan keterampilan dari AWS Agen Toolkit. Anda bisa mendapatkan keterampilan katalog dengan cara berikut:
+ **Dibundel dengan plugin** - Instal `aws-data-analytics` plugin, yang mencakup serangkaian keterampilan katalog yang tersedia untuk agen segera setelah instalasi. Untuk petunjuk, lihat [Menginstal plugin](https://docs.aws.amazon.com/agent-toolkit/latest/userguide/plugins.html#installing-plugins) di Panduan Pengguna Toolkit AWS Agen.
+ **Diinstal secara lokal** — Unduh keterampilan individu dari Agen Toolkit untuk AWS repositori GitHub dan tambahkan ke direktori keterampilan agen Anda. Alur kerja katalog dukungan keterampilan berikut:
  + [menjelajahi-data-katalog](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/exploring-data-catalog)
  + [penemuan-data-danau-aset](https://github.com/aws/agent-toolkit-for-aws/tree/main/skills/specialized-skills/analytics-skills/finding-data-lake-assets)

## Langkah selanjutnya
<a name="business-context-getting-started-next-steps"></a>
+ Lampirkan formulir untuk menstandarisasi bidang metadata seperti residensi data atau kebijakan penyimpanan.
+ Buat aset keterampilan yang menyediakan agen AI dengan konteks domain untuk data Anda.