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

# API tampilan yang terwujud
<a name="aws-glue-api-catalog-materialized-views"></a>

API tampilan terwujud menjelaskan jenis AWS Glue data dan operasi untuk memulai, menghentikan, dan memantau menjalankan tugas penyegaran tampilan yang terwujud.

## Jenis Data
<a name="aws-glue-api-catalog-materialized-views-objects"></a>
+ [MaterializedViewRefreshTaskRun struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun)

## MaterializedViewRefreshTaskRun struktur
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun"></a>

Objek yang menunjukkan rincian tugas penyegaran tampilan terwujud yang dijalankan.

**Bidang**
+ `CustomerId`— UTF-8 string, panjangnya tidak lebih dari 12 byte.

  ID AWS akun.
+ `MaterializedViewRefreshTaskRunId`— UTF-8 string, cocok dengan[Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Pengidentifikasi tugas penyegaran tampilan terwujud dijalankan.
+ `DatabaseName`— UTF-8 tali.

  Database tempat tabel berada.
+ `TableName`— UTF-8 tali.

  Nama tampilan yang terwujud.
+ `CatalogId` — String id katalog, sepanjang tidak kurang dari 1 atau lebih dari 255 byte, yang cocok dengan [Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID akun digunakan secara default.
+ `Role`— UTF-8 tali.

  Peran IAM yang diasumsikan layanan untuk menjalankan tugas penyegaran tampilan yang terwujud.
+ `Status`— UTF-8 string (nilai valid: `STARTING` \| `RUNNING` \| `SUCCEEDED` \| `FAILED` \|`STOPPED`).

  Status tugas yang dijalankan.
+ `CreationTime` — Stempel waktu.

  Waktu tugas ini dibuat.
+ `LastUpdated` — Stempel waktu.

  Titik terakhir dalam waktu ketika tugas ini dimodifikasi.
+ `StartTime` — Stempel waktu.

  Waktu mulai tugas.
+ `EndTime` — Stempel waktu.

  Waktu akhir tugas.
+ `ErrorMessage` — String deskripsi, dengan panjang tidak lebih dari 2048 byte, yang cocok dengan [URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri).

  Pesan kesalahan untuk pekerjaan.
+ `DPUSeconds` — Nomor (ganda).

  Penggunaan DPU yang dihitung dalam hitungan detik untuk semua pekerja yang diskalakan otomatis.
+ `RefreshType`— UTF-8 string (nilai valid: `FULL` \|`INCREMENTAL`).

  Jenis tugas refresh yang dijalankan. Baik penuh atau inkremental.
+ `ProcessedBytes` — Nomor (panjang).

  Jumlah byte yang dijalankan tugas refresh telah dipindai untuk menyegarkan tampilan yang terwujud.

## Operasi
<a name="aws-glue-api-catalog-materialized-views-actions"></a>
+ [StartMaterializedViewRefreshTaskRun tindakan (Python: start\_materialized\_view\_refresh h\_task\_run)](#aws-glue-api-catalog-materialized-views-StartMaterializedViewRefreshTaskRun)
+ [StopMaterializedViewRefreshTaskRun tindakan (Python: stop\_materialized\_view\_refresh h\_task\_run)](#aws-glue-api-catalog-materialized-views-StopMaterializedViewRefreshTaskRun)
+ [GetMaterializedViewRefreshTaskRun tindakan (Python: get\_materialized\_view\_refresh h\_task\_run)](#aws-glue-api-catalog-materialized-views-GetMaterializedViewRefreshTaskRun)
+ [ListMaterializedViewRefreshTaskRuns tindakan (Python: list\_materialized\_view\_refresh h\_task\_runs)](#aws-glue-api-catalog-materialized-views-ListMaterializedViewRefreshTaskRuns)

## StartMaterializedViewRefreshTaskRun tindakan (Python: start\_materialized\_view\_refresh h\_task\_run)
<a name="aws-glue-api-catalog-materialized-views-StartMaterializedViewRefreshTaskRun"></a>

Memulai menjalankan tugas penyegaran tampilan terwujud untuk tampilan terwujud tertentu.

**Permintaan**
+ `CatalogId`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID akun digunakan secara default.
+ `DatabaseName`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama database tempat tabel berada.
+ `TableName`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama tampilan terwujud untuk menjalankan tugas penyegaran.
+ `FullRefresh` – Boolean.

  Menentukan apakah ini adalah penyegaran penuh dari tugas yang dijalankan.

**Respons**
+ `MaterializedViewRefreshTaskRunId`— UTF-8 string, cocok dengan[Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Pengidentifikasi untuk menjalankan tugas penyegaran tampilan terwujud.

**Kesalahan**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `MaterializedViewRefreshTaskRunningException`
+ `OperationTimeoutException`
+ `ResourceNumberLimitExceededException`
+ `InvalidInputException`

## StopMaterializedViewRefreshTaskRun tindakan (Python: stop\_materialized\_view\_refresh h\_task\_run)
<a name="aws-glue-api-catalog-materialized-views-StopMaterializedViewRefreshTaskRun"></a>

Menghentikan menjalankan tugas penyegaran tampilan terwujud untuk tampilan terwujud tertentu.

**Permintaan**
+ `CatalogId`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID akun digunakan secara default.
+ `DatabaseName`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama database tempat tabel berada.
+ `TableName`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama tampilan yang terwujud.

**Respons**
+ *Tidak ada parameter Respons. *

**Kesalahan**
+ `AccessDeniedException`
+ `MaterializedViewRefreshTaskNotRunningException`
+ `MaterializedViewRefreshTaskStoppingException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## GetMaterializedViewRefreshTaskRun tindakan (Python: get\_materialized\_view\_refresh h\_task\_run)
<a name="aws-glue-api-catalog-materialized-views-GetMaterializedViewRefreshTaskRun"></a>

Dapatkan yang terkait metadata/information untuk menjalankan tugas, diberi ID menjalankan tugas.

**Permintaan**
+ `CatalogId`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID akun digunakan secara default.
+ `MaterializedViewRefreshTaskRunId`— * Diperlukan: * UTF-8 string, cocok dengan[Custom string pattern #48](aws-glue-api-common.md#regex_48).

  Pengidentifikasi untuk menjalankan tugas penyegaran tampilan terwujud tertentu.

**Respons**
+ `MaterializedViewRefreshTaskRun` — Sebuah objek [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun).

  Sebuah MaterializedViewRefreshTaskRun objek yang mewakili detail tugas yang dijalankan.

**Kesalahan**
+ `AccessDeniedException`
+ `EntityNotFoundException`
+ `OperationTimeoutException`
+ `InvalidInputException`

## ListMaterializedViewRefreshTaskRuns tindakan (Python: list\_materialized\_view\_refresh h\_task\_runs)
<a name="aws-glue-api-catalog-materialized-views-ListMaterializedViewRefreshTaskRuns"></a>

Daftar semua tugas yang dijalankan untuk akun tertentu.

**Permintaan**
+ `CatalogId`- * Diperlukan: * UTF-8 string, panjang tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  ID dari Katalog Data tempat tabel berada. Jika tidak ada yang disediakan, ID akun digunakan secara default.
+ `DatabaseName`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Database tempat tabel berada.
+ `TableName`— UTF-8 string, panjangnya tidak kurang dari 1 atau lebih dari 255 byte, cocok dengan[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine).

  Nama tampilan yang terwujud.
+ `MaxResults` — Nomor (bilangan bulat), tidak kurang dari 1 atau lebih dari 1000.

  Ukuran maksimum respons.
+ `NextToken`— UTF-8 tali.

  Sebuah token kelanjutan, jika ini adalah panggilan kelanjutan.

**Respons**
+ `MaterializedViewRefreshTaskRuns` – Susunan objek [MaterializedViewRefreshTaskRun](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRun).

  Hasil ListMaterializedViewRefreshTaskRuns tindakan. 
+ `NextToken`— UTF-8 tali.

  Token lanjutan, jika belum semua ID run tugas telah dikembalikan.

**Kesalahan**
+ `AccessDeniedException`
+ `InvalidInputException`
+ `OperationTimeoutException`

## Pengecualian
<a name="aws-glue-api-catalog-materialized-views-exceptions"></a>
+ [MaterializedViewRefreshTaskRunningException struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRunningException)
+ [MaterializedViewRefreshTaskNotRunningException struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskNotRunningException)
+ [MaterializedViewRefreshTaskStoppingException struktur](#aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskStoppingException)

## MaterializedViewRefreshTaskRunningException struktur
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskRunningException"></a>

Pengecualian dilemparkan ketika tugas sudah dalam keadaan berjalan.

**Bidang**
+ `Message`— UTF-8 tali.

  Sebuah pesan yang menjelaskan masalah.

## MaterializedViewRefreshTaskNotRunningException struktur
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskNotRunningException"></a>

Pengecualian dilemparkan saat menghentikan tugas yang tidak dalam keadaan berjalan.

**Bidang**
+ `Message`— UTF-8 tali.

  Sebuah pesan yang menjelaskan masalah.

## MaterializedViewRefreshTaskStoppingException struktur
<a name="aws-glue-api-catalog-materialized-views-MaterializedViewRefreshTaskStoppingException"></a>

Pengecualian dilemparkan ketika tugas sudah dalam keadaan berhenti.

**Bidang**
+ `Message`— UTF-8 tali.

  Sebuah pesan yang menjelaskan masalah.