Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、[ブログ記事](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)を参照してください。
# メインクラスターの SVL ビュー
SVL ビューは、STL テーブルへのリファレンスと詳細情報のログを含む Amazon Redshift のシステムビューです。
これらのビューを使用すると、それらのテーブルで検索された一般的なクエリデータにすばやく簡単にアクセスできます。
**注記**
SVL\$1QUERY\$1SUMMARY ビューには、Amazon Redshift によって実行されたクエリに関する情報のみが含まれます。その他のユーティリティや DDL コマンドの情報は含まれません。Amazon Redshift によって実行されたすべてのステートメントの完全なリストと、DDL およびユーティリティコマンドを含めた情報については、SVL\$1STATEMENTTEXT ビューをクエリできます。
**Topics**
+ [
# SVL\$1AUTO\$1WORKER\$1ACTION
](r_SVL_AUTO_WORKER_ACTION.md)
+ [
# SVL\$1COMPILE
](r_SVL_COMPILE.md)
+ [
# SVL\$1DATASHARE\$1CHANGE\$1LOG
](r_SVL_DATASHARE_CHANGE_LOG.md)
+ [
# SVL\$1DATASHARE\$1CROSS\$1REGION\$1USAGE
](r_SVL_DATASHARE_CROSS_REGION_USAGE.md)
+ [
# SVL\$1DATASHARE\$1USAGE\$1CONSUMER
](r_SVL_DATASHARE_USAGE_CONSUMER.md)
+ [
# SVL\$1DATASHARE\$1USAGE\$1PRODUCER
](r_SVL_DATASHARE_USAGE_PRODUCER.md)
+ [
# SVL\$1FEDERATED\$1QUERY
](r_SVL_FEDERATED_QUERY.md)
+ [
# SVL\$1MULTI\$1STATEMENT\$1VIOLATIONS
](r_SVL_MULTI_STATEMENT_VIOLATIONS.md)
+ [
# SVL\$1MV\$1REFRESH\$1STATUS
](r_SVL_MV_REFRESH_STATUS.md)
+ [
# SVL\$1QERROR
](r_SVL_QERROR.md)
+ [
# SVL\$1QLOG
](r_SVL_QLOG.md)
+ [
# SVL\$1QUERY\$1METRICS
](r_SVL_QUERY_METRICS.md)
+ [
# SVL\$1QUERY\$1METRICS\$1SUMMARY
](r_SVL_QUERY_METRICS_SUMMARY.md)
+ [
# SVL\$1QUERY\$1QUEUE\$1INFO
](r_SVL_QUERY_QUEUE_INFO.md)
+ [
# SVL\$1QUERY\$1REPORT
](r_SVL_QUERY_REPORT.md)
+ [
# SVL\$1QUERY\$1SUMMARY
](r_SVL_QUERY_SUMMARY.md)
+ [
# SVL\$1RESTORE\$1ALTER\$1TABLE\$1PROGRESS
](r_SVL_RESTORE_ALTER_TABLE_PROGRESS.md)
+ [
# SVL\$1S3LIST
](r_SVL_S3LIST.md)
+ [
# SVL\$1S3LOG
](r_SVL_S3LOG.md)
+ [
# SVL\$1S3PARTITION
](r_SVL_S3PARTITION.md)
+ [
# SVL\$1S3PARTITION\$1SUMMARY
](r_SVL_S3PARTITION_SUMMARY.md)
+ [
# SVL\$1S3QUERY
](r_SVL_S3QUERY.md)
+ [
# SVL\$1S3QUERY\$1SUMMARY
](r_SVL_S3QUERY_SUMMARY.md)
+ [
# SVL\$1S3RETRIES
](r_SVL_S3RETRIES.md)
+ [
# SVL\$1SPATIAL\$1SIMPLIFY
](r_SVL_SPATIAL_SIMPLIFY.md)
+ [
# SVL\$1SPECTRUM\$1SCAN\$1ERROR
](r_SVL_SPECTRUM_SCAN_ERROR.md)
+ [
# SVL\$1STATEMENTTEXT
](r_SVL_STATEMENTTEXT.md)
+ [
# SVL\$1STORED\$1PROC\$1CALL
](r_SVL_STORED_PROC_CALL.md)
+ [
# SVL\$1STORED\$1PROC\$1MESSAGES
](r_SVL_STORED_PROC_MESSAGES.md)
+ [
# SVL\$1TERMINATE
](r_SVL_TERMINATE.md)
+ [
# SVL\$1UDF\$1LOG
](r_SVL_UDF_LOG.md)
+ [
# SVL\$1USER\$1INFO
](r_SVL_USER_INFO.md)
+ [
# SVL\$1VACUUM\$1PERCENTAGE
](r_SVL_VACUUM_PERCENTAGE.md)
# SVL\$1AUTO\$1WORKER\$1ACTION
自動最適化用に定義されたテーブルに Amazon Redshift によって実行された自動アクションを記録します。
SVL\$1AUTO\$1WORKER\$1ACTION はスーパーユーザーにのみ表示されます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_AUTO_WORKER_ACTION.html)
`status` 列値の例は次のとおりです。
+ スキップ: テーブルが見つかりませんでした。
+ スキップ: 推奨値は空です。
+ スキップ: ソートキー推奨の適用が無効になっています。
+ スキップ: 再試行がテーブルの最大制限を超えています。
+ スキップ: テーブルの列が変更されました。
+ 中止: このテーブルは AUTO ではありません。
+ 中止: このテーブルは最近変換されました。
+ 中止: このテーブルはテーブルサイズのしきい値を超えています。
+ 中止: このテーブルはすでに推奨されているスタイルです。
+ チェックポイント: 進捗状況 *21.9963*％。
## サンプルクエリ
次の例では、結果の行に Amazon Redshift が実行したアクションが表示されます。
```
select table_id, type, status, eventtime, sequence, previous_state
from SVL_AUTO_WORKER_ACTION;
```
```
table_id | type | status | eventtime | sequence | previous_state
----------+---------+------------------------------------------------------+----------------------------+----------+----------------
118082 | sortkey | Start | 2020-08-22 19:42:20.727049 | 0 |
118078 | sortkey | Start | 2020-08-22 19:43:54.728819 | 0 |
118082 | sortkey | Start | 2020-08-22 19:42:52.690264 | 0 |
118072 | sortkey | Start | 2020-08-22 19:44:14.793572 | 0 |
118082 | sortkey | Failed | 2020-08-22 19:42:20.728917 | 0 |
118078 | sortkey | Complete | 2020-08-22 19:43:54.792705 | 0 | SORTKEY: None;
118086 | sortkey | Complete | 2020-08-22 19:42:00.72635 | 0 | SORTKEY: None;
118082 | sortkey | Complete | 2020-08-22 19:43:34.728144 | 0 | SORTKEY: None;
118072 | sortkey | Skipped:Retry exceeds the maximum limit for a table. | 2020-08-22 19:44:46.706155 | 0 |
118086 | sortkey | Start | 2020-08-22 19:42:00.685255 | 0 |
118082 | sortkey | Start | 2020-08-22 19:43:34.69531 | 0 |
118072 | sortkey | Start | 2020-08-22 19:44:46.703331 | 0 |
118082 | sortkey | Checkpoint: progress 14.755079% | 2020-08-22 19:42:52.692828 | 0 |
118072 | sortkey | Failed | 2020-08-22 19:44:14.796071 | 0 |
116723 | sortkey | Abort:This table is not AUTO. | 2020-10-28 05:12:58.479233 | 0 |
110203 | distkey | Abort:This table is not AUTO. | 2020-10-28 05:45:54.67259 | 0 |
```
# SVL\$1COMPILE
クエリの各クエリセグメントのコンパイル時間と位置を記録します。
SVL\$1COMPILE はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
**注記**
SVL\$1COMPILE には、メインのプロビジョニング済みクラスターで実行されるクエリのみが含まれます。同時実行スケーリングクラスターやサーバーレス名前空間で実行されるクエリは含まれていません。メインクラスターと、同時実行スケーリングクラスターやサーバーレス名前空間の両方で実行されるクエリの説明プランにアクセスするには、SYS モニタリングビュー [SYS\$1QUERY\$1HISTORY](SYS_QUERY_HISTORY.md) を使用することをお勧めします。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。
SVCS\$1COMPILE の詳細については、「[SVCS\$1COMPILE](r_SVCS_COMPILE.md)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_COMPILE.html)
## サンプルクエリ
この例では、クエリ 35878 と 35879 が同じ SQL ステートメントを実行します。クエリ 35878 の compile 列では 4 つのクエリセグメントに対して `1` が表示されており、それらのセグメントがコンパイルされたことを示しています。クエリ 35879 の compile 列ではすべてのセグメントについて `0` が表示されており、セグメントを再びコンパイルする必要がなかったことを示しています。
```
select userid, xid, pid, query, segment, locus,
datediff(ms, starttime, endtime) as duration, compile
from svl_compile
where query = 35878 or query = 35879
order by query, segment;
userid | xid | pid | query | segment | locus | duration | compile
--------+--------+-------+-------+---------+-------+----------+---------
100 | 112780 | 23028 | 35878 | 0 | 1 | 0 | 0
100 | 112780 | 23028 | 35878 | 1 | 1 | 0 | 0
100 | 112780 | 23028 | 35878 | 2 | 1 | 0 | 0
100 | 112780 | 23028 | 35878 | 3 | 1 | 0 | 0
100 | 112780 | 23028 | 35878 | 4 | 1 | 0 | 0
100 | 112780 | 23028 | 35878 | 5 | 1 | 0 | 0
100 | 112780 | 23028 | 35878 | 6 | 1 | 1380 | 1
100 | 112780 | 23028 | 35878 | 7 | 1 | 1085 | 1
100 | 112780 | 23028 | 35878 | 8 | 1 | 1197 | 1
100 | 112780 | 23028 | 35878 | 9 | 2 | 905 | 1
100 | 112782 | 23028 | 35879 | 0 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 1 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 2 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 3 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 4 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 5 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 6 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 7 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 8 | 1 | 0 | 0
100 | 112782 | 23028 | 35879 | 9 | 2 | 0 | 0
(20 rows)
```
# SVL\$1DATASHARE\$1CHANGE\$1LOG
プロデューサークラスターとコンシューマークラスターの両方でデータ共有への変更を追跡するための統合ビューを記録します。
SVL\$1DATASHARE\$1CHANGE\$1LOG はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1DATASHARE\$1CHANGE\$1LOG](SYS_DATASHARE_CHANGE_LOG.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_DATASHARE_CHANGE_LOG.html)
## サンプルクエリ
次の例は、SVL\$1DATACHARE\$1CHANGE\$1LOG ビューを示しています。
```
SELECT DISTINCT action
FROM svl_datashare_change_log
WHERE share_object_name LIKE 'tickit%';
action
-----------------------
"ALTER DATASHARE ADD"
```
# SVL\$1DATASHARE\$1CROSS\$1REGION\$1USAGE
SVL\$1DATASHARE\$1CROSS\$1REGION\$1USAGE ビューを使用して、クロスリージョンデータ共有クエリによって発生したクロスリージョンデータ転送使用量の概要を取得します。SVL\$1DATASHARE\$1CROSS\$1REGION\$1USAGE はセグメントレベルで詳細を集計します。
SVL\$1DATASHARE\$1CROSS\$1REGION\$1USAGE はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1DATASHARE\$1CROSS\$1REGION\$1USAGE](r_SYS_DATASHARE_CROSS_REGION_USAGE.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_DATASHARE_CROSS_REGION_USAGE.html)
## サンプルクエリ
次の例は、SVL\$1DATASHARE\$1CROSS\$1REGION\$1USAGE ビューを示しています。
```
SELECT query, segment, transferred_data, source_region
from svl_datashare_cross_region_usage
where query = pg_last_query_id()
order by query,segment;
query | segment | transferred_data | source_region
--------+---------+------------------+---------------
200048 | 2 | 4194304 | us-west-1
200048 | 2 | 4194304 | us-east-2
```
# SVL\$1DATASHARE\$1USAGE\$1CONSUMER
データ共有のアクティビティと使用状況を記録します。このビューは、コンシューマークラスターにのみ関連しています。
SVL\$1DATASHARE\$1USAGE\$1CONSUMER はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1DATASHARE\$1USAGE\$1CONSUMER](SYS_DATASHARE_USAGE_CONSUMER.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_DATASHARE_USAGE_CONSUMER.html)
## サンプルクエリ
次の例は、SVL\$1DATASHARE\$1USAGE\$1CONSUMER ビューを示しています。
```
SELECT request_type, status, trim(error) AS error
FROM svl_datashare_usage_consumer
request_type | status | error
----------------+--------+--------
"GET RELATION" | 0 |
```
# SVL\$1DATASHARE\$1USAGE\$1PRODUCER
データ共有のアクティビティと使用状況を記録します。このビューは、コンシューマークラスターにのみ関連しています。
SVL\$1DATASHARE\$1USAGE\$1PRODUCER はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1DATASHARE\$1USAGE\$1PRODUCER](SYS_DATASHARE_USAGE_PRODUCER.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_DATASHARE_USAGE_PRODUCER.html)
## サンプルクエリ
次の例は、SVL\$1DATACHARE\$1USAGE\$1PRODUCER ビューを示しています。
```
SELECT DISTINCT request_type
FROM svl_datashare_usage_producer
WHERE object_name LIKE 'tickit%';
request_type
------------------
"GET RELATION"
```
# SVL\$1FEDERATED\$1QUERY
SVL\$1FEDERATED\$1QUERY ビューは、フェデレーテッドクエリの呼び出しに関する情報を表示するために使用します。
SVL\$1FEDERATED\$1QUERY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1EXTERNAL\$1QUERY\$1DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_FEDERATED_QUERY.html)
## サンプルクエリ
フェデレーテッドクエリの呼び出しに関する情報を表示するには、次のようなクエリを実行します。
```
select query, trim(sourcetype) as type, recordtime, trim(querytext) as "PG Subquery" from svl_federated_query where query = 4292;
query | type | recordtime | pg subquery
-------+------+----------------------------+---------------------------------------------------------------
4292 | PG | 2020-03-27 04:29:58.485126 | SELECT "level" FROM functional.employees WHERE ("level" >= 6)
(1 row)
```
# SVL\$1MULTI\$1STATEMENT\$1VIOLATIONS
SVL\$1MULTI\$1STATEMENT\$1VIOLATIONS ビューを使用して、トランザクションブロックの制限に違反するシステムで実行されたすべての SQL コマンドの完全なレコードを取得します。
Amazon Redshift がトランザクションブロックまたはマルチステートメントのリクエスト内で制限する次の SQL コマンドのいずれかを実行すると、違反が発生します。
+ [CREATE DATABASE](r_CREATE_DATABASE.md)
+ [DROP DATABASE](r_DROP_DATABASE.md)
+ [ALTER TABLE APPEND](r_ALTER_TABLE_APPEND.md)
+ [CREATE EXTERNAL TABLE](r_CREATE_EXTERNAL_TABLE.md)
+ DROP EXTERNAL TABLE
+ RENAME EXTERNAL TABLE
+ ALTER EXTERNAL TABLE
+ CREATE TABLESPACE
+ DROP TABLESPACE
+ [ライブラリを作成する](r_CREATE_LIBRARY.md)
+ [DROP LIBRARY](r_DROP_LIBRARY.md)
+ REBUILDCAT
+ INDEXCAT
+ REINDEX DATABASE
+ [VACUUM](r_VACUUM_command.md)
+ [GRANT](r_GRANT.md)
+ [COPY](r_COPY.md)
**注記**
このビューにエントリがある場合は、対応するアプリケーションおよび SQL スクリプトを変更します。アプリケーションコードを変更して、これらの制限された SQL コマンドの使用をトランザクションブロックの外に移動することをお勧めします。さらにサポートが必要な場合は、AWS サポートにお問い合わせください。
SVL\$1MULTI\$1STATEMENT\$1VIOLATIONS はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1HISTORY](SYS_QUERY_HISTORY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_MULTI_STATEMENT_VIOLATIONS.html)
## サンプルクエリ
次のクエリは、違反がある複数のステートメントを返します。
```
select * from svl_multi_statement_violations order by starttime asc;
userid | database | cmdname | xid | pid | label | starttime | endtime | sequence | type | text
==============================================================================================================================
1 | dev | CREATE DATABASE | 1034 | 5729 |label1 | ********* | ******* | 0 | DDL | create table c(b int);
1 | dev | CREATE DATABASE | 1034 | 5729 |label1 | ********* | ******* | 0 | UTILITY | create database b;
1 | dev | CREATE DATABASE | 1034 | 5729 |label1 | ********* | ******* | 0 | UTILITY | COMMIT
...
```
# SVL\$1MV\$1REFRESH\$1STATUS
SVL\$1MV\$1REFRESH\$1STATUS ビューには、マテリアライズドビューの更新作業用の行が含まれています。
マテリアライズドビューの詳細については、「[Amazon Redshift でのマテリアライズドビュー](materialized-view-overview.md)」を参照してください。
SVL\$1MV\$1REFRESH\$1STATUS はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1MV\$1REFRESH\$1HISTORY](SYS_MV_REFRESH_HISTORY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_MV_REFRESH_STATUS.html)
## サンプルクエリ
マテリアライズドビューの更新ステータスを表示するには、次のクエリを実行します。
```
select * from svl_mv_refresh_status;
```
このクエリは、次のサンプル出力を返します。
```
db_name | userid | schema | name | xid | starttime | endtime | status | refresh_type | consumer_account | consumer_region | consumer_namespace
---------+--------+-----------+---------+-------+----------------------------+----------------------------+-------------------------------------------------------------------------------------+---------------+------------------+-----------------+------------------------------------
dev | 169 | mv_schema | mv_test | 6640 | 2020-02-14 02:26:53.497935 | 2020-02-14 02:26:53.556156 | Refresh successfully recomputed MV from scratch | Manual | | |
dev | 166 | mv_schema | mv_test | 6517 | 2020-02-14 02:26:39.287438 | 2020-02-14 02:26:39.349539 | Refresh successfully updated MV incrementally | Auto | | |
ext_db | 162 | producer_schema | producer_mv | 6388 | 2020-02-14 02:26:27.863426 | 2020-02-14 02:26:27.918307 | Refresh successfully updated MV incrementally | Manual | 0123456789 | us-east-1 | 623d8ff2-4391-4381-83d7-177caa6767af
dev | 161 | mv_schema | mv_test | 6323 | 2020-02-14 02:26:20.020717 | 2020-02-14 02:26:20.080002 | Refresh successfully updated MV incrementally | Auto | | |
dev | 161 | mv_schema | mv_test | 6301 | 2020-02-14 02:26:05.796146 | 2020-02-14 02:26:07.853986 | Refresh successfully recomputed MV from scratch | Manual | | |
dev | 153 | mv_schema | mv_test | 6024 | 2020-02-14 02:25:18.762335 | 2020-02-14 02:25:20.043462 | MV was already updated | Manual | | |
dev | 143 | mv_schema | mv_test | 5557 | 2020-02-14 02:24:23.100601 | 2020-02-14 02:24:23.100633 | MV was already updated | Manual
dev | 141 | mv_schema | mv_test | 5447 | 2020-02-14 02:23:54.102837 | 2020-02-14 02:24:00.310166 | Refresh successfully updated MV incrementally | Auto
dev | 1 | mv_schema | mv_test | 5329 | 2020-02-14 02:22:26.328481 | 2020-02-14 02:22:28.369217 | Refresh successfully recomputed MV from scratch | Auto
dev | 138 | mv_schema | mv_test | 5290 | 2020-02-14 02:21:56.885093 | 2020-02-14 02:21:56.885098 | Refresh failed. MV was not found | Manual
dev | 138 | mv_schema | mv_test | 5100 | 2020-02-14 02:20:33.123445 | 2020-02-14 02:20:33.123445 | Cascade refresh failed because materialized view mv_schema.child was not refreshed. | Manual
dev | 138 | mv_schema | child | 5100 | 2020-02-14 02:20:33.123445 | 2020-02-14 02:20:33.123445 | Refresh failed due to an internal error. | Manual
dev | 138 | mv_schema | mv_test | 5099 | 2020-02-14 02:10:23.492344 | 2020-02-14 02:10:23.492344 | Cascade refresh skipped because materialized view mv_schema.child was not refreshed.| Manual
dev | 138 | mv_schema | child | 5099 | 2020-02-14 02:10:23.492344 | 2020-02-14 02:10:23.492344 | Refresh failed due to an internal error. | Manual
```
# SVL\$1QERROR
SVL\$1QERROR ビューは廃止されました。
# SVL\$1QLOG
SVL\$1QLOG ビューにはデータベースに対して実行されたすべてのクエリのログが含まれます。
Amazon Redshift は [STL\$1QUERY](r_STL_QUERY.md) テーブルから取得した情報の読み込み可能なサブセットとして SVL\$1QLOG ビューを作成します。このテーブルを使用して最近実行されたクエリのクエリ ID を検索したり、クエリが完了するまでにかかった時間を確認します。
SVL\$1QLOG はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1HISTORY](SYS_QUERY_HISTORY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_QLOG.html)
## サンプルクエリ
以下の例では、`userid = 100` のユーザーによって実行された最近 5 つのデータベースクエリのクエリ ID、実行時間、および切り捨てられたクエリテキストが返されます。
```
select query, pid, elapsed, substring from svl_qlog
where userid = 100
order by starttime desc
limit 5;
query | pid | elapsed | substring
--------+-------+----------+-----------------------------------------------
187752 | 18921 | 18465685 | select query, elapsed, substring from svl_...
204168 | 5117 | 59603 | insert into testtable values (100);
187561 | 17046 | 1003052 | select * from pg_table_def where tablename...
187549 | 17046 | 1108584 | select * from STV_WLM_SERVICE_CLASS_CONFIG
187468 | 17046 | 5670661 | select * from pg_table_def where schemaname...
(5 rows)
```
次の例では、キャンセルされたクエリ (**aborted=1**) の SQL スクリプト名 (LABEL 列) と経過時間を返します。
```
select query, elapsed, trim(label) querylabel
from svl_qlog where aborted=1;
query | elapsed | querylabel
-------+----------+-------------------------
16 | 6935292 | alltickittablesjoin.sql
(1 row)
```
# SVL\$1QUERY\$1METRICS
SVL\$1QUERY\$1METRICS は、完了したクエリのメトリクスを表示します。このビューは [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md) システムテーブルから取得されます。このビューの値は、クエリのモニタリングルールを定義するしきい値を決定する際に役立ちます。詳細については、「[WLM クエリモニタリングルール](cm-c-wlm-query-monitoring-rules.md)」を参照してください。
SVL\$1QUERY\$1METRICS はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1DETAIL](SYS_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_QUERY_METRICS.html)
# SVL\$1QUERY\$1METRICS\$1SUMMARY
SVL\$1QUERY\$1METRICS\$1SUMMARY ビューは、完了したクエリのメトリクスの最大値を示します。このビューは [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md) システムテーブルから取得されます。このビューの値は、クエリのモニタリングルールを定義するしきい値を決定する際に役立ちます。Amazon Redshift のクエリモニタリングのルールとメトリクスの詳細については、「[WLM クエリモニタリングルール](cm-c-wlm-query-monitoring-rules.md)」を参照してください。
SVL\$1QUERY\$1METRICS\$1SUMMARY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1DETAIL](SYS_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_QUERY_METRICS_SUMMARY.html)
# SVL\$1QUERY\$1QUEUE\$1INFO
ワークロード管理 (WLM) クエリキューまたはコミットキューで時間がかかったクエリの詳細が示されます。
SVL\$1QUERY\$1QUEUE\$1INFO ビューは、システムによって実行されたクエリをフィルタリングし、ユーザーによって実行されたクエリのみを表示します。
SVL\$1QUERY\$1QUEUE\$1INFO ビューでは、[STL\$1QUERY](r_STL_QUERY.md)、[STL\$1WLM\$1QUERY](r_STL_WLM_QUERY.md)、および [STL\$1COMMIT\$1STATS](r_STL_COMMIT_STATS.md) システムテーブルからの情報の概要が表示されます。
SVL\$1QUERY\$1QUEUE\$1INFO はスーパーユーザーのみに表示されます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_QUERY_QUEUE_INFO.html)
## サンプルクエリ
次の例は、WLM キューでクエリにかかった時間を示しています。
```
select query, service_class, queue_elapsed, exec_elapsed, wlm_total_elapsed
from svl_query_queue_info
where wlm_total_elapsed > 0;
query | service_class | queue_elapsed | exec_elapsed | wlm_total_elapsed
---------+---------------+---------------+--------------+-------------------
2742669 | 6 | 2 | 916 | 918
2742668 | 6 | 4 | 197 | 201
(2 rows)
```
# SVL\$1QUERY\$1REPORT
Amazon Redshift は、Amazon Redshift の STL システムテーブルのいくつかを UNION (結合) したものから SVL\$1QUERY\$1REPORT ビューを作成し、完了済みのクエリステップに関する情報を提供します。
このビューは、完了済みのクエリに関する情報を、スライスごと、およびステップごとに分類します。これは、Amazon Redshift クラスターでのノードやスライスの問題のトラブルシューティングに役立ちます。
SVL\$1QUERY\$1REPORT はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1DETAIL](SYS_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_QUERY_REPORT.html)
## サンプルクエリ
次のクエリは、クエリ ID 279 のクエリを実行したときに返される行のデータの偏りを示します。このクエリを使用して、データベースのデータがデータウェアハウスクラスターのスライス全体に均等に分散されているかどうかを確認します。
```
select query, segment, step, max(rows), min(rows),
case when sum(rows) > 0
then ((cast(max(rows) -min(rows) as float)*count(rows))/sum(rows))
else 0 end
from svl_query_report
where query = 279
group by query, segment, step
order by segment, step;
```
このクエリにより返されるデータは、以下のサンプルの出力のようになります。
```
query | segment | step | max | min | case
------+---------+------+----------+----------+----------------------
279 | 0 | 0 | 19721687 | 19721687 | 0
279 | 0 | 1 | 19721687 | 19721687 | 0
279 | 1 | 0 | 986085 | 986084 | 1.01411202804304e-06
279 | 1 | 1 | 986085 | 986084 | 1.01411202804304e-06
279 | 1 | 4 | 986085 | 986084 | 1.01411202804304e-06
279 | 2 | 0 | 1775517 | 788460 | 1.00098637606408
279 | 2 | 2 | 1775517 | 788460 | 1.00098637606408
279 | 3 | 0 | 1775517 | 788460 | 1.00098637606408
279 | 3 | 2 | 1775517 | 788460 | 1.00098637606408
279 | 3 | 3 | 1775517 | 788460 | 1.00098637606408
279 | 4 | 0 | 1775517 | 788460 | 1.00098637606408
279 | 4 | 1 | 1775517 | 788460 | 1.00098637606408
279 | 4 | 2 | 1 | 1 | 0
279 | 5 | 0 | 1 | 1 | 0
279 | 5 | 1 | 1 | 1 | 0
279 | 6 | 0 | 20 | 20 | 0
279 | 6 | 1 | 1 | 1 | 0
279 | 7 | 0 | 1 | 1 | 0
279 | 7 | 1 | 0 | 0 | 0
(19 rows)
```
# SVL\$1QUERY\$1SUMMARY
SVL\$1QUERY\$1SUMMARY ビューを使用して、クエリの実行についての全般的な情報を確認します。
SVL\$1QUERY\$1SUMMARY ビューには SVL\$1QUERY\$1REPORT ビューからのデータのサブセットが含まれます。SVL\$1QUERY\$1SUMMARY の情報はすべてのノードからの情報の集計であることに注意してください。
**注記**
SVL\$1QUERY\$1SUMMARY ビューには、Amazon Redshift によって実行されたクエリに関する情報のみが含まれます。その他のユーティリティや DDL コマンドの情報は含まれません。Amazon Redshift によって実行されたすべてのステートメントの完全なリストと、DDL およびユーティリティコマンドを含めた情報については、SVL\$1STATEMENTTEXT ビューをクエリできます。
SVL\$1QUERY\$1SUMMARY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1DETAIL](SYS_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
SVCS\$1QUERY\$1SUMMARY の詳細については、「[SVCS\$1QUERY\$1SUMMARY](r_SVCS_QUERY_SUMMARY.md)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_QUERY_SUMMARY.html)
## サンプルクエリ
**クエリステップの処理情報を表示する**
次のクエリは、クエリ 87 の各ステップの基本的な処理情報を示します。
```
select query, stm, seg, step, rows, bytes
from svl_query_summary
where query = 87
order by query, seg, step;
```
このクエリは次のサンプル出力で示されているように、クエリ 87 についての処理情報を取得します。
```
query | stm | seg | step | rows | bytes
-------+-----+-----+------+--------+---------
87 | 0 | 0 | 0 | 90 | 1890
87 | 0 | 0 | 2 | 90 | 360
87 | 0 | 1 | 0 | 90 | 360
87 | 0 | 1 | 2 | 90 | 1440
87 | 1 | 2 | 0 | 210494 | 4209880
87 | 1 | 2 | 3 | 89500 | 0
87 | 1 | 2 | 6 | 4 | 96
87 | 2 | 3 | 0 | 4 | 96
87 | 2 | 3 | 1 | 4 | 96
87 | 2 | 4 | 0 | 4 | 96
87 | 2 | 4 | 1 | 1 | 24
87 | 3 | 5 | 0 | 1 | 24
87 | 3 | 5 | 4 | 0 | 0
(13 rows)
```
**クエリステップがディスクに書き出されたかどうかを確認する**
次のクエリは、クエリ ID 1025 ([SVL\$1QLOG](r_SVL_QLOG.md) を参照して、クエリのクエリ ID の取得方法を確認してください) のクエリのステップがディスクに書き出されたかどうか、またはクエリが完全にインメモリで実行されたかどうかを示します。
```
select query, step, rows, workmem, label, is_diskbased
from svl_query_summary
where query = 1025
order by workmem desc;
```
このクエリは、次のサンプル出力を返します。
```
query| step| rows | workmem | label | is_diskbased
-----+-----+--------+-----------+---------------+--------------
1025 | 0 |16000000| 141557760 |scan tbl=9 | f
1025 | 2 |16000000| 135266304 |hash tbl=142 | t
1025 | 0 |16000000| 128974848 |scan tbl=116536| f
1025 | 2 |16000000| 122683392 |dist | f
(4 rows)
```
IS\$1DISKBASED の値をスキャンすることで、ディスクに書き出されたクエリステップを確認できます。クエリ 1025 のハッシュステップはディスクで実行されました。ディスクで実行される可能性があるステップは、ハッシュ、集計、ソートステップを含みます。ディスクベースクエリのステップのみを表示するには、前述の例の SQL ステートメントに **and is\$1diskbased = 't'** 句を追加します。
# SVL\$1RESTORE\$1ALTER\$1TABLE\$1PROGRESS
SVL\$1RESTORE\$1ALTER\$1TABLE\$1PROGRESS を使用して、RA3 ノードへの従来のサイズ変更中のクラスター内の各テーブルについて、移行の進行状況をモニタリングします。サイズ変更操作中のデータ移行の履歴スループットをキャプチャします。RA3 ノードへの従来のサイズ変更について詳しくは、「[従来のサイズ変更](https://docs.aws.amazon.com/redshift/latest/mgmt/managing-cluster-operations.html#classic-resize-faster)」を参照してください。
SVL\$1RESTORE\$1ALTER\$1TABLE\$1PROGRESS はスーパーユーザーのみに表示されます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1RESTORE\$1LOG](SYS_RESTORE_LOG.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
**注記**
進行状況が `100.00%` または `ABORTED` の行は 7 日後に削除されます。従来のサイズ変更中またはサイズ変更後に削除されたテーブルの行は、引き続き SVL\$1RESTORE\$1ALTER\$1TABLE\$1PROGRESS に表示されることがあります。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_RESTORE_ALTER_TABLE_PROGRESS.html)
## サンプルクエリ
次のクエリは、実行中とキューに登録されたクエリを返します。
```
select * from svl_restore_alter_table_progress;
tbl | progress | message
--------+----------+-----------------------------------------------------------
105614 | ABORTED | Abort:Table no longer contains the prior dist key column.
105610 | ABORTED | Abort:Table no longer contains the prior dist key column.
105594 | 0.00% | Table waiting for alter diststyle conversion.
105602 | ABORTED | Abort:Table no longer contains the prior dist key column.
105606 | ABORTED | Abort:Table no longer contains the prior dist key column.
105598 | 100.00% | Restored to distkey successfully.
```
# SVL\$1S3LIST
SVL\$1S3LIST ビューを使用して、セグメントレベルで Amazon Redshift Spectrum クエリの詳細を確認します。
SVL\$1S3LIST はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
**注記**
SVL\$1S3LIST には、メインのプロビジョニング済みクラスターで実行されるクエリのみが含まれます。同時実行スケーリングクラスターやサーバーレス名前空間で実行されるクエリは含まれていません。メインクラスターと、同時実行スケーリングクラスターやサーバーレス名前空間の両方で実行されるクエリの説明プランにアクセスするには、SYS モニタリングビュー [SYS\$1EXTERNAL\$1QUERY\$1DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md) を使用することをお勧めします。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_S3LIST.html)
## サンプルクエリ
以下の例は、最後に実行されるクエリについて SVL\$1S3LIST をクエリします。
```
select *
from svl_s3list
where query = pg_last_query_id()
order by query,segment;
```
# SVL\$1S3LOG
SVL\$1S3LOG ビューを使用して、セグメントおよびノードスライスレベルで Amazon Redshift Spectrum クエリの詳細を確認します。
SVL\$1S3LOG はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
**注記**
SVL\$1S3LOG には、メインのプロビジョニング済みクラスターで実行されるクエリのみが含まれます。同時実行スケーリングクラスターやサーバーレス名前空間で実行されるクエリは含まれていません。メインクラスターと、同時実行スケーリングクラスターやサーバーレス名前空間の両方で実行されるクエリの説明プランにアクセスするには、SYS モニタリングビュー [SYS\$1EXTERNAL\$1QUERY\$1DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md) を使用することをお勧めします。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_S3LOG.html)
## サンプルクエリ
以下の例は、最後に実行されたクエリについて SVL\$1S3LOG をクエリします。
```
select *
from svl_s3log
where query = pg_last_query_id()
order by query,segment,slice;
```
# SVL\$1S3PARTITION
SVL\$1S3PARTITION ビューを使用して、セグメントおよびノードスライスレベルで Amazon Redshift Spectrum パーティションの詳細を確認します。
SVL\$1S3PARTITION はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
**注記**
SVL\$1S3PARTITION には、メインのプロビジョニング済みクラスターで実行されるクエリのみが含まれます。同時実行スケーリングクラスターやサーバーレス名前空間で実行されるクエリは含まれていません。メインクラスターと、同時実行スケーリングクラスターやサーバーレス名前空間の両方で実行されるクエリの説明プランにアクセスするには、SYS モニタリングビュー [SYS\$1EXTERNAL\$1QUERY\$1DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md) を使用することをお勧めします。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_S3PARTITION.html)
## サンプルクエリ
以下の例は、最後に完了されたクエリに関するパーティションの詳細を取得します。
```
SELECT query, segment,
MIN(starttime) AS starttime,
MAX(endtime) AS endtime,
datediff(ms,MIN(starttime),MAX(endtime)) AS dur_ms,
MAX(total_partitions) AS total_partitions,
MAX(qualified_partitions) AS qualified_partitions,
MAX(assignment) as assignment_type
FROM svl_s3partition
WHERE query=pg_last_query_id()
GROUP BY query, segment
```
```
query | segment | starttime | endtime | dur_ms| total_partitions | qualified_partitions | assignment_type
------+---------+-------------------------------+-----------------------------+-------+------------------+----------------------+----------------
99232 | 0 | 2018-04-17 22:43:50.201515 | 2018-04-17 22:43:54.674595 | 4473 | 2526 | 334 | p
```
# SVL\$1S3PARTITION\$1SUMMARY
SVL\$1S3PARTITION\$1SUMMARY ビューを使用して、セグメントレベルで Redshift Spectrum クエリパーティションの概要を取得します。
SVL\$1S3PARTITION\$1SUMMARY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
SVCS\$1S3PARTITION の詳細については、「[SVCS\$1S3PARTITION\$1SUMMARY](r_SVCS_S3PARTITION_SUMMARY.md)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_S3PARTITION_SUMMARY.html)
## サンプルクエリ
以下の例は、最後に完了されたクエリに関するパーティションスキャンの詳細を取得します。
```
select query, segment, assignment, min_starttime, max_endtime, min_duration, avg_duration
from svl_s3partition_summary
where query = pg_last_query_id()
order by query,segment;
```
# SVL\$1S3QUERY
SVL\$1S3QUERY ビューを使用して、セグメントおよびノードスライスレベルで Amazon Redshift Spectrum クエリの詳細を確認します。
SVL\$1S3QUERY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
**注記**
SVL\$1S3QUERY には、メインのプロビジョニング済みクラスターで実行されるクエリのみが含まれます。同時実行スケーリングクラスターやサーバーレス名前空間で実行されるクエリは含まれていません。メインクラスターと、同時実行スケーリングクラスターやサーバーレス名前空間の両方で実行されるクエリの説明プランにアクセスするには、SYS モニタリングビュー [SYS\$1EXTERNAL\$1QUERY\$1DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md) を使用することをお勧めします。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_S3QUERY.html)
## サンプルクエリ
以下の例は、最後に完了されたクエリに関するスキャンステップの詳細を取得します。
```
select query, segment, slice, elapsed, s3_scanned_rows, s3_scanned_bytes, s3query_returned_rows, s3query_returned_bytes, files
from svl_s3query
where query = pg_last_query_id()
order by query,segment,slice;
```
```
query | segment | slice | elapsed | s3_scanned_rows | s3_scanned_bytes | s3query_returned_rows | s3query_returned_bytes | files
------+---------+-------+---------+-----------------+------------------+-----------------------+------------------------+------
4587 | 2 | 0 | 67811 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 1 | 591568 | 172462 | 11260097 | 8513 | 170260 | 1
4587 | 2 | 2 | 216849 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 3 | 216671 | 0 | 0 | 0 | 0 | 0
```
# SVL\$1S3QUERY\$1SUMMARY
SVL\$1S3QUERY\$1SUMMARY ビューを使用して、システムで実行されたすべての Amazon Redshift Spectrum クエリ (S3 クエリ) 概要を取得します。SVL\$1S3QUERY\$1SUMMARY は、SVL\$1S3QUERY の詳細をセグメントレベルで集計します。
SVL\$1S3QUERY\$1SUMMARY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1EXTERNAL\$1QUERY\$1DETAIL](SYS_EXTERNAL_QUERY_DETAIL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
SVCS\$1S3QUERY\$1SUMMARY については、「[SVCS\$1S3QUERY\$1SUMMARY](r_SVCS_S3QUERY_SUMMARY.md)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_S3QUERY_SUMMARY.html)
## サンプルクエリ
以下の例は、最後に完了されたクエリに関するスキャンステップの詳細を取得します。
```
select query, segment, elapsed, s3_scanned_rows, s3_scanned_bytes, s3query_returned_rows, s3query_returned_bytes, files
from svl_s3query_summary
where query = pg_last_query_id()
order by query,segment;
```
```
query | segment | elapsed | s3_scanned_rows | s3_scanned_bytes | s3query_returned_rows | s3query_returned_bytes | files
------+---------+---------+-----------------+------------------+-----------------------+------------------------+------
4587 | 2 | 67811 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 591568 | 172462 | 11260097 | 8513 | 170260 | 1
4587 | 2 | 216849 | 0 | 0 | 0 | 0 | 0
4587 | 2 | 216671 | 0 | 0 | 0 | 0 | 0
```
# SVL\$1S3RETRIES
SVL\$1S3RETRIES ビューを使用して、Amazon S3 に基づく Amazon Redshift Spectrum クエリが失敗した理由に関する情報を入手します。
SVL\$1S3RETRIES はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_S3RETRIES.html)
## サンプルクエリ
次の例では、失敗した S3 クエリに関するデータを取得します。
```
SELECT svl_s3retries.query, svl_s3retries.segment, svl_s3retries.node, svl_s3retries.slice, svl_s3retries.eventtime, svl_s3retries.retries,
svl_s3retries.successful_fetches, svl_s3retries.file_size, btrim((svl_s3retries."location")::text) AS "location", btrim((svl_s3retries.message)::text)
AS message FROM svl_s3retries;
```
# SVL\$1SPATIAL\$1SIMPLIFY
システムビュー SVL\$1SPATIAL\$1SIMPLIFY をクエリして、COPY コマンドを使用して、簡略化された空間ジオメトリオブジェクトに関する情報を取得できます。シェープファイルで COPY を使用する場合、SIMPLIFY `tolerance`、SIMPLIFY AUTO、および SIMPLIFY AUTO `max_tolerance` の取り込みオプションを指定できます。簡略化の結果は SVL\$1SPATIAL\$1SIMPLIFY システムビューに要約されます。
SIMPLIFY AUTO `max_tolerance` が設定されている場合、このビューには、最大サイズを超えた各ジオメトリの行が含まれます。SIMPLIFY `tolerance` が設定されている場合、COPY オペレーション全体の 1 行が保存されます。この行は、COPY クエリ ID と指定された簡略化の許容値を参照します。
SVL\$1SPATIAL\$1SIMPLIFY はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1SPATIAL\$1SIMPLIFY](SYS_SPATIAL_SIMPLIFY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_SPATIAL_SIMPLIFY.html)
## サンプルクエリ
次のクエリは、COPY で簡略化されたレコードのリストを返します。
```
SELECT * FROM svl_spatial_simplify WHERE query = pg_last_copy_id();
query | line_number | maximum_tolerance | initial_size | simplified | final_size | final_tolerance
-------+-------------+-------------------+--------------+------------+------------+----------------------
20 | 1184704 | -1 | 1513736 | t | 1008808 | 1.276386653895e-05
20 | 1664115 | -1 | 1233456 | t | 1023584 | 6.11707814796635e-06
```
# SVL\$1SPECTRUM\$1SCAN\$1ERROR
システムビュー SVL\$1SPECTRUM\$1SCAN\$1ERROR をクエリして Redshift Spectrum スキャンエラーに関する情報を取得することができます。
SVL\$1SPECTRUM\$1SCAN\$1ERROR はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1EXTERNAL\$1QUERY\$1ERROR](SYS_EXTERNAL_QUERY_ERROR.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
ログに記録されたエラーのサンプルを表示します。デフォルトは、クエリあたり 10 エントリです。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_SPECTRUM_SCAN_ERROR.html)
## サンプルクエリ
次のクエリは、データ処理操作が実行された行のリストを返します。
```
SELECT * FROM svl_spectrum_scan_error;
```
クエリによって以下のような結果が返されます。
```
userid query location rowid colname original_value modified_value trigger action action_valueerror_code
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:0 league_name Barclays Premier League Barclays Premier Lea UNSPECIFIED TRUNCATE 156
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:0 league_nspi 34595 32767 UNSPECIFIED OVERFLOW_VALUE 199
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:1 league_nspi 34151 32767 UNSPECIFIED OVERFLOW_VALUE 199
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:2 league_name Barclays Premier League Barclays Premier Lea UNSPECIFIED TRUNCATE 156
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:2 league_nspi 33223 32767 UNSPECIFIED OVERFLOW_VALUE 199
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:3 league_name Barclays Premier League Barclays Premier Lea UNSPECIFIED TRUNCATE 156
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:3 league_nspi 32808 32767 UNSPECIFIED OVERFLOW_VALUE 199
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:4 league_nspi 32790 32767 UNSPECIFIED OVERFLOW_VALUE 199
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:5 league_name Spanish Primera Division Spanish Primera Divi UNSPECIFIED TRUNCATE 156
100 1574007 s3://spectrum-uddh/league/spi_global_rankings.0:6 league_name Spanish Primera Division Spanish Primera Divi UNSPECIFIED TRUNCATE 156
```
# SVL\$1STATEMENTTEXT
SVL\$1STATEMENTTEXT ビューを使用して、システムで実行されたすべての SQL コマンドの完全な記録を取得します。
SVL\$1STATEMENTTEXT ビューには[STL\$1DDLTEXT](r_STL_DDLTEXT.md)、[STL\$1QUERYTEXT](r_STL_QUERYTEXT.md)、[STL\$1UTILITYTEXT](r_STL_UTILITYTEXT.md) テーブルのすべての行の統合が含まれます。また、このビューには STL\$1QUERY テーブルの結合も含まれます。
SVL\$1STATEMENTTEXT はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1HISTORY](SYS_QUERY_HISTORY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_STATEMENTTEXT.html)
## サンプルクエリ
次のクエリでは、2009 年 6 月 16 日に実行された DDL ステートメントを返します。
```
select starttime, type, rtrim(text) from svl_statementtext
where starttime like '2009-06-16%' and type='DDL' order by starttime asc;
starttime | type | rtrim
---------------------------|------|--------------------------------
2009-06-16 10:36:50.625097 | DDL | create table ddltest(c1 int);
2009-06-16 15:02:16.006341 | DDL | drop view alltickitjoin;
2009-06-16 15:02:23.65285 | DDL | drop table sales;
2009-06-16 15:02:24.548928 | DDL | drop table listing;
2009-06-16 15:02:25.536655 | DDL | drop table event;
...
```
### ストアド SQL の再構築
SVL\$1STATEMENTTEXT の `text` 列に保存されている SQL を再構築するには、SELECT ステートメントを実行して、`text` 列の 1 つ以上の部分から SQL を作成します。再構築された SQL を実行する前に、特殊文字 (`\n`) がある場合は、改行に置き換えます。次の SELECT ステートメントの結果は、`query_statement`フィールドに再構築された SQL の行です。
```
select LISTAGG(CASE WHEN LEN(RTRIM(text)) = 0 THEN text ELSE RTRIM(text) END, '') within group (order by sequence) AS query_statement
from SVL_STATEMENTTEXT where pid=pg_backend_pid();
```
例えば、次のクエリでは 3 つの列を選択します。クエリ自体は 200 文字より長く、SVL\$1STATEMENTTEXT の部分に保存されます。
```
select
1 AS a0123456789012345678901234567890123456789012345678901234567890,
2 AS b0123456789012345678901234567890123456789012345678901234567890,
3 AS b012345678901234567890123456789012345678901234
FROM stl_querytext;
```
この例では、クエリは SVL\$1STATEMENTTEXT の `text` 列の 2 つの部分 (行) に保存されます。
```
select sequence, text from SVL_STATEMENTTEXT where pid = pg_backend_pid() order by starttime, sequence;
```
```
sequence | text
----------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
0 | select\n1 AS a0123456789012345678901234567890123456789012345678901234567890,\n2 AS b0123456789012345678901234567890123456789012345678901234567890,\n3 AS b012345678901234567890123456789012345678901234
1 | \nFROM stl_querytext;
```
STL\$1STATEMENTTEXT に保存された SQL を再構築するには、次の SQL を実行します。
```
select LISTAGG(CASE WHEN LEN(RTRIM(text)) = 0 THEN text ELSE RTRIM(text) END, '') within group (order by sequence) AS text
from SVL_STATEMENTTEXT where pid=pg_backend_pid();
```
再構築された SQL をクライアントで使用するには、特殊文字 (`\n`) を改行に置き換えます。
```
text
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
select\n1 AS a0123456789012345678901234567890123456789012345678901234567890,\n2 AS b0123456789012345678901234567890123456789012345678901234567890,\n3 AS b012345678901234567890123456789012345678901234\nFROM stl_querytext;
```
# SVL\$1STORED\$1PROC\$1CALL
システムビュー SVL\$1STORED\$1PROC\$1CALL をクエリして、ストアドプロシージャコールに関する開始時刻、終了時刻、およびコールがキャンセルされたかどうかなどの情報を取得できます。ストアドプロシージャ呼び出しごとにクエリ ID を受け取ります。
SVL\$1STORED\$1PROC\$1CALL はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1PROCEDURE\$1CALL](SYS_PROCEDURE_CALL.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_STORED_PROC_CALL.html)
## サンプルクエリ
次のクエリは、降順の経過時間と、過去 1 日のストアドプロシージャ呼び出しの完了ステータスを返します。
```
select query, datediff(seconds, starttime, endtime) as elapsed_time, aborted, trim(querytxt) as call from svl_stored_proc_call where starttime >= getdate() - interval '1 day' order by 2 desc;
query | elapsed_time | aborted | call
--------+--------------+---------+-----------------------------------------------------------------------------------
4166 | 7 | 0 | call search_batch_status(35,'succeeded');
2433 | 3 | 0 | call test_batch (123456)
1810 | 1 | 0 | call prod_benchmark (123456)
1836 | 1 | 0 | call prod_testing (123456)
1808 | 1 | 0 | call prod_portfolio ('N', 123456)
1816 | 1 | 1 | call prod_portfolio ('Y', 123456)
```
# SVL\$1STORED\$1PROC\$1MESSAGES
システムビュー SVL\$1STORED\$1PROC\$1MESSAGES を照会して、ストアドプロシージャメッセージに関する情報を取得できます。ストアドプロシージャコールがキャンセルされた場合でも、発生したメッセージがログに記録されます。ストアドプロシージャ呼び出しごとにクエリ ID を受け取ります。ログ記録されるメッセージの最小レベルを設定する方法の詳細については、stored\$1proc\$1log\$1min\$1messages を参照してください。
SVL\$1STORED\$1PROC\$1MESSAGES はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1PROCEDURE\$1MESSAGES](SYS_PROCEDURE_MESSAGES.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_STORED_PROC_MESSAGES.html)
## サンプルクエリ
次の SQL ステートメントは、SVL\$1STORED\$1PROC\$1MESSAGES を使用して発行されたメッセージを確認する方法を示しています。
```
-- Create and run a stored procedure
CREATE OR REPLACE PROCEDURE test_proc1(f1 int) AS
$$
BEGIN
RAISE INFO 'Log Level: Input f1 is %',f1;
RAISE NOTICE 'Notice Level: Input f1 is %',f1;
EXECUTE 'select invalid';
RAISE NOTICE 'Should not print this';
EXCEPTION WHEN OTHERS THEN
raise exception 'EXCEPTION level: Exception Handling';
END;
$$ LANGUAGE plpgsql;
-- Call this stored procedure
CALL test_proc1(2);
-- Show raised messages with level higher than INFO
SELECT query, recordtime, loglevel, loglevel_text, trim(message) as message, aborted FROM svl_stored_proc_messages
WHERE loglevel > 30 AND query = 193 ORDER BY recordtime;
query | recordtime | loglevel | loglevel_text | message | aborted
-------+----------------------------+----------+---------------+-------------------------------------+---------
193 | 2020-03-17 23:57:18.277196 | 40 | NOTICE | Notice Level: Input f1 is 2 | 1
193 | 2020-03-17 23:57:18.277987 | 60 | EXCEPTION | EXCEPTION level: Exception Handling | 1
(2 rows)
-- Show raised messages at EXCEPTION level
SELECT query, recordtime, loglevel, loglevel_text, trim(message) as message, aborted FROM svl_stored_proc_messages
WHERE loglevel_text = 'EXCEPTION' AND query = 193 ORDER BY recordtime;
query | recordtime | loglevel | loglevel_text | message | aborted
-------+----------------------------+----------+---------------+-------------------------------------+---------
193 | 2020-03-17 23:57:18.277987 | 60 | EXCEPTION | EXCEPTION level: Exception Handling | 1
```
次の SQL ステートメントは、ストアドプロシージャの作成時に、SET オプションと SVL\$1STORED\$1PROC\$1MESSAGES を使用して発行されたメッセージを表示する方法を示します。test\$1proc() には最低ログレベルの NOTICE があるため、SVL\$1STORED\$1PROC\$1MESSAGES には、NOTICE、WARNING、EXCEPTION レベルのメッセージのみが記録されます。
```
-- Create a stored procedure with minimum log level of NOTICE
CREATE OR REPLACE PROCEDURE test_proc() AS
$$
BEGIN
RAISE LOG 'Raise LOG messages';
RAISE INFO 'Raise INFO messages';
RAISE NOTICE 'Raise NOTICE messages';
RAISE WARNING 'Raise WARNING messages';
RAISE EXCEPTION 'Raise EXCEPTION messages';
RAISE WARNING 'Raise WARNING messages again'; -- not reachable
END;
$$ LANGUAGE plpgsql SET stored_proc_log_min_messages = NOTICE;
-- Call this stored procedure
CALL test_proc();
-- Show the raised messages
SELECT query, recordtime, loglevel_text, trim(message) as message, aborted FROM svl_stored_proc_messages
WHERE query = 149 ORDER BY recordtime;
query | recordtime | loglevel_text | message | aborted
-------+----------------------------+---------------+--------------------------+---------
149 | 2020-03-16 21:51:54.847627 | NOTICE | Raise NOTICE messages | 1
149 | 2020-03-16 21:51:54.84766 | WARNING | Raise WARNING messages | 1
149 | 2020-03-16 21:51:54.847668 | EXCEPTION | Raise EXCEPTION messages | 1
(3 rows)
```
# SVL\$1TERMINATE
ユーザーがプロセスをキャンセルまたは終了した時刻を記録します。
SELECT PG\$1TERMINATE\$1BACKEND(*pid*)、SELECT PG\$1CANCEL\$1BACKEND(*pid*)、および CANCEL *pid* は、SVL\$1TERMINATE にログのエントリを作成します。
SVL\$1TERMINATE は、スーパーユーザーにのみ表示されます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1QUERY\$1HISTORY](SYS_QUERY_HISTORY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_TERMINATE.html)
次のコマンドでは、キャンセルされた最新のクエリが表示されます。
```
select * from svl_terminate order by eventtime desc limit 1;
pid | eventtime | userid | type
------+----------------------------+--------+--------
8324 | 2020-03-24 09:42:07.298937 | 1 | CANCEL
(1 row)
```
# SVL\$1UDF\$1LOG
システムで定義された、ユーザー定義関数 (UDF) の実行時に生成するエラーと警告メッセージを記録します。
SVL\$1UDF\$1LOG はすべてのユーザーに表示されます。スーパーユーザーはすべての行を表示できますが、通常のユーザーは自分のデータのみを表示できます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1UDF\$1LOG](SYS_UDF_LOG.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_UDF_LOG.html)
## サンプルクエリ
次の例では UDF がシステム定義されたエラーをどのように処理するかを示します。最初のブロックは、引数の逆を返す UDF 関数の定義を示します。2 番目のブロックに示すように、関数を実行して引数を 0 に指定すると、関数はエラーを返します。3 番目のステートメントは、SVL\$1UDF\$1LOG とログされたエラーメッセージを読み取ります
```
-- Create a function to find the inverse of a number
CREATE OR REPLACE FUNCTION f_udf_inv(a int)
RETURNS float IMMUTABLE
AS $$
return 1/a
$$ LANGUAGE plpythonu;
-- Run the function with a 0 argument to create an error
Select f_udf_inv(0) from sales;
-- Query SVL_UDF_LOG to view the message
Select query, created, message::varchar
from svl_udf_log;
query | created | message
-------+----------------------------+---------------------------------------------------------
2211 | 2015-08-22 00:11:12.04819 | ZeroDivisionError: long division or modulo by zero\nNone
```
次の例では、UDF にログされたメッセージと警告メッセージを追加することで、ゼロで分割された操作がエラーメッセージで停止する代わりに警告メッセージとなります。
```
-- Create a function to find the inverse of a number and log a warning
CREATE OR REPLACE FUNCTION f_udf_inv_log(a int)
RETURNS float IMMUTABLE
AS $$
import logging
logger = logging.getLogger() #get root logger
if a==0:
logger.warning('You attempted to divide by zero.\nReturning zero instead of error.\n')
return 0
else:
return 1/a
$$ LANGUAGE plpythonu;
```
次の例は、関数を実行し、その後 SVL\$1UDF\$1LOG をクエリしていうメッセージを表示します。
```
-- Run the function with a 0 argument to trigger the warning
Select f_udf_inv_log(0) from sales;
-- Query SVL_UDF_LOG to view the message
Select query, created, message::varchar
from svl_udf_log;
query | created | message
------+----------------------------+----------------------------------
0 | 2015-08-22 00:11:12.04819 | You attempted to divide by zero.
Returning zero instead of error.
```
# SVL\$1USER\$1INFO
SVL\$1USER\$1INFO ビューを使用して、Amazon Redshift データベースユーザーに関するデータを取得できます。
SVL\$1USER\$1INFO はスーパーユーザーのみに表示されます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_USER_INFO.html)
## サンプルクエリ
次のコマンドは SVL\$1USER\$1INFO からユーザー情報を取得します。
```
SELECT * FROM SVL_USER_INFO;
```
# SVL\$1VACUUM\$1PERCENTAGE
SVL\$1VACUUM\$1PERCENTAGE ビューはバキューム処理の実行後にテーブルに割り当てられるデータブロックのパーセントを示します。このパーセント数は再利用されたディスクスペースの量を示します。バキューム処理ユーティリティの詳細については、[VACUUM](r_VACUUM_command.md) コマンドを参照してください。
SVL\$1VACUUM\$1PERCENTAGE はスーパーユーザーのみに表示されます。詳細については、「[システムテーブルとビューのデータの可視性](cm_chap_system-tables.md#c_visibility-of-data)」を参照してください。
このテーブルの一部またはすべてのデータは、SYS モニタリングビュー [SYS\$1VACUUM\$1HISTORY](SYS_VACUUM_HISTORY.md) でも確認できます。SYS モニタリングビューのデータは、使いやすく理解しやすいようにフォーマットされます。クエリには、SYS モニタリングビューを使用することをお勧めします。
## テーブルの列
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/redshift/latest/dg/r_SVL_VACUUM_PERCENTAGE.html)
## サンプルクエリ
次のクエリは、テーブル 100238 での具体的な処理のパーセントを示します。
```
select * from svl_vacuum_percentage
where table_id=100238 and xid=2200;
xid | table_id | percentage
-----+----------+------------
1337 | 100238 | 60
(1 row)
```
バキューム処理後、テーブルには元のブロックの 60% が含まれます。