詳細リストについて

構成

詳細リストはRedisに保存されます。独自のRedisインスタンスを提供、構成、および維持する必要があります。2025.10以降、詳細リスト用にRedisの複数のインスタンスを構成できるようになりました。ご使用の環境に合わせてRedisを構成する方法については、リストデータサービス (SAS Viyaプラットフォーム: 構成プロパティ)を参照してください。

リスト作成

リストを作成するときは、その機能、ステータス、場所、構造を定義します。

リストの機能は、リストプロパティ(名前、ラベル、説明など)で定義されます。リストの名前を指定する必要があります。ラベルと説明はオプションです。

リストのステータスは、配置済みまたは開発中です。配置済みリストは、他のSASアプリケーションおよびワークフローで使用できます。開発中リストは、他のSASアプリケーションおよびワークフローで使用できません。リストを作成すると、作成中にリストを配置するように指定しない限り、デフォルトの状態は開発中となります。

リストを不変として指定できます。つまり、リストにデータが追加されると、コンテンツを変更できません。不変リストの詳細については、不変リストを参照してください。

各リストを保存する場所を指定する必要があります。デフォルトの場所は/SAS Content/Products/List Dataです。フォルダーの詳細については、フォルダー: 概要 (SAS Viyaプラットフォーム: フォルダー)を参照してください。

リストの構造は、リストに含まれるデータを表すために定義する列です。リストの構造を手動で定義して後でデータをインポートするか、リスト構造を定義するCSVファイルをアップロードし、そのファイル内のデータもインポートすることができます。

アイテムが配置されるときに、リスト内のアイテムに有効期限があることを指定できます。有効期限を使用すると、指定されたリストアイテムがコンシューマーによって使用されなくなる日時を設定できます。新しいリストを作成するときは、リストアイテムの有効期限を設定するオプションを有効にする必要があります。既存のリストではこのオプションを有効にすることはできません。

少なくとも1つの列をキー列として指定しない限り、リストは有効ではありません。この列は、コンテンツデータストアからレコードを取得するためのルックアップキーを構築するために使用されます。複数の列をキーとして識別することで、複雑なルックアップキーを作成することができます。

リストリビジョン

詳細リストのリビジョンを作成したり、最新のリビジョンのコンテンツを変更したり、リビジョンのコンテンツを表示したり、どのリストリビジョンを表示および配置するかを設定したり、複数のリビジョンのコンテンツを比較したりできます。

作成する新しいリストはそれぞれ、リストの最初のリビジョンになります。これはリストのバージョンタブのバージョン1です。後続のリストリビジョンを作成する場合、バージョン1は、別のバージョンの表示を選択するまで、リストコンテンツとプロパティのタブに表示されるバージョンです。

最新リビジョンのみを変更できます。(詳細については、リストコンテンツの変更を参照してください。)他のすべてのリビジョンのコンテンツを表示できます。

リストを配置するときは、別のバージョンの配置を指定しない限り、表示されているバージョンを配置します。配置できるリストのバージョンは1つだけです。バージョンタブの配置済み列のは、配置されているリビジョンを示します。配置済みリストを開発中に移動すると、リストとリビジョンが配置されなくなります。リストの配置済みおよび開発中のステータスについては、リスト作成を参照してください。

複数のリストリビジョンのコンテンツを選択して比較できます。比較にマスクされていないバージョンはありません。特権ユーザーのみが、バージョン内のマスクされたコンテンツを表示できます。バージョン間で変更された値は、比較でハイライト表示されます。

リスト定義の変更

次のルールに基づいて、既存のリストの構造とプロパティを変更できます。

• リストが空の場合は、ラベルや説明などの特定のプロパティを変更したり、列名、データの種類、データマスク、キー列などの列情報を変更したりできます。
  重要 環境で列名の制限が有効になっている場合、リストを変更するときに列名は DS2 の変数名規則に準拠する必要があります。列名の制限の詳細については、列名の制限を参照してください。
• リストにデータが含まれている場合は、ラベルや説明などの特定のプロパティを変更できます。リスト列情報またはキー列は変更できません。

リストコンテンツの変更

次のルールに基づいて、既存のリストのデータを変更できます。

• リストが空の場合は、手動でデータを追加するか、CSVファイルからデータをインポートできます。
• リストにデータが含まれている場合は、次の操作を実行できます。
  注: 不変リストのコンテンツの管理に関連する一部の機能は制限されています。これらの制限については、不変リストで説明します。
  • CSVファイルからデータを手動で追加またはインポートします。
  • 最新のリストリビジョンのコンテンツを変更します。改訂が適用されている場合、ステータスとキー列の値を変更することはできません。また、特権ユーザーはマスクされた値を変更することはできません。リストリビジョンの詳細については、リストリビジョンを参照してください。
  • 特定のリストアイテムのステータスを変更します。開発中のリストアイテムは、他のSASアプリケーションおよびワークフローでは使用できません。配置済みのリストアイテムは、他のSASアプリケーションおよびワークフローで使用できます。
    注: 指定したリストアイテムのステータスを変更しても、リストのステータスは変更されません。たとえば、開発中のリストにアイテムを配置すると、リストのステータスは開発中のままです。この場合、リストを配置するときにリスト行は"配置済み"としてマークされます。
  • 配置済みアイテムの有効期限を設定または削除します。
    注: 新しいリストを作成するときは、リストアイテムの有効期限を設定するオプションを有効にする必要があります。(詳細については、リストの作成を参照してください。)既存のリストではこのオプションを有効にすることはできません。リストアイテムの有効期限が切れると、そのステータスはアーカイブになります。アーカイブされたアイテムはRedisでまだ使用可能で、再配置できます。
  • 特権ユーザーの場合は、データマスクを変更して改訂されたデータを表示します。データマスクの詳細については、データマスクを参照してください。

CSVファイルのインポート、リストのコンテンツ全体の削除、リストのコンテンツの更新などの特定のタスクには、大規模なデータセットが必要になる場合があります。その結果、これらのプロセスは完了するまでに時間がかかることがあります。長時間実行されているタスクは、詳細リストのジョブタブに記録されます。このタブでは、アプリケーションで作業を続けているときに開始されたジョブのステータスを確認したり、以前のジョブの詳細を確認したり、ジョブのログを開いて失敗したジョブに関する情報を得たりすることができます。すぐに完了するタスクは、このタブの履歴レコードに追加されません。

データマスク

詳細リストは、データマスクを通じてリスト内のセンシティブなデータを保護する機能を提供します。リスト内のデータをマスクすると、リスト列全体のデータ値のすべてまたは一部が出力で改訂されます。たとえば、次の図では、リストビューでパスワード文字列全体が改訂されていますが、電話番号は最後の4桁以外はすべて改訂されています。

リスト内のデータのマスキングには、次のルールが適用されます。

• リスト作成者は、リストの作成時にリスト列のデータマスクを指定できます。
• リスト変更者は、データを含まない既存のリスト内の列のデータマスクを変更できます。
• データを含むリスト内のデータマスクを変更できるのは、特権ユーザーのみです。この権限は、管理者によってユーザーに付与されます。
  注: 機能へのアクセスの提供については、Access to Functionality: Overview (SAS Viya Platform: Access to Functionality)を参照してください。

デフォルトでは、マスクされたデータはリストビューで改訂されます。リストビューで改訂のオンとオフを切り替えることができるのは特権ユーザーのみです。改訂がオンの場合、マスクされた値を変更できません。リストの変更の詳細については、リストコンテンツの変更を参照してください。

不変リスト

リストを不変と指定すると、リストの作成後はリストのコンテンツを変更できないように指定されます。不変リストは、CSVファイルをインポートして新しいリストを作成する場合にのみ指定できます。このファイルはリストを定義し、そのコンテンツを生成します。コンテンツを含む不変リストが作成された後は、リストのコンテンツを更新またはクリアすることはできません。不変リストを配置し、配置済みリストを開発中に移動することはできますが、不変リスト内の特定のアイテムに対して同じアクションを実行することはできません。特権ユーザーの場合は、データマスクを変更したり、不変リストを削除したりできます。データマスクの詳細については、データマスクを参照してください。

列名の制限

2026.03 以降、詳細リストでは、DS2 変数名規則に基づく列名制限が適用されます。DS2 言語の詳細については、DS2言語について (SAS DS2プログラマガイド)を参照してください。useColumnNameDS2Restrictionsプロパティは、デフォルトで環境構成で有効になっており、ルールセットで詳細リストをエラーなしで参照できるようになっています。列名の制限の有効化または無効化については、 リストデータサービス (SAS Viyaプラットフォーム: 構成プロパティ)を参照してください。

制限が有効になっている場合、新しいリストを作成する際、または既存のリストで列名を変更する際には、列名は次のルールに従う必要があります。

• 最小長は1文字、最大長は32文字です。
• 名前は、単一のアンダースコア (_) または文字 (a-z、A-Z) で始まる必要があります。名前を連続する複数のアンダースコアで始めることはできません (__abcは無効です)。
• 名前には文字 (a–z、A–Z)、数字 (0–9)、アンダースコア (_) のみを含めることができます。
• 名前をDS2の予約語 (キーワードまたはデータの種類) にすることはできません。文区切り文字のリストについては、DS2言語の予約語 (SAS DS2プログラマガイド)を参照してください。
  注: ルールセットで使用される詳細リストの列名も、予約語 TRUE、FALSE、または _N_ を列名として使用することはできません。
• 列名では大文字と小文字が区別されず、リスト内で一意である必要があります。
• 列名には非ラテン文字は使用できません。