SAS Cloud Analytic Services: リファレンス

CASサーバーにある、一部のCASログメッセージのJSONログ行に含まれる文字列を指定します。

apptag='my_app'

Azureストレージシステムに接続するためのログイン情報をキャッシュするために使用される場所を指定します。このオプションは、デバイスコード認証で使用でき、オプションとなります。

パスを設定するには、sas.cas.instance.config: configインスタンスを編集します。

Azureストレージシステムに接続するためのテナントIDを指定します。値の最大長は64バイトです。英数字とハイフン(-)のみがサポートされています。

SAS言語コンパイラで使用するコード生成最適化の種類を指定します。

• optimization-value

  SASコンパイラが使用する最適化の種類を指定します。引用符で囲まれたスペース区切りリストとして、次の1つ以上を指定します。

  • 'dumptkgcode' | 'nodumptkgcode'

    すべてのCASサーバーノードが生成されたプログラムで出力ファイルを作成するかどうかを指定します。CASログには、CASが出力ファイルを書き込む場所がリストされます。

  • 'extramath' | 'noextramath'

    コンパイラがステートメントの結果に影響を与えない余分な算術演算を保持するのかそれとも削除するのかを指定します。

  • 'funcdifferencing' | 'nofuncdifferencing'

    funcdifferencingを指定すると、ユーザー定義関数の数値微分導関数が計算されます。nofuncdifferencingを指定すると、ユーザー定義関数の分析導関数が計算されます。

  • 'guardcheck' | 'noguardcheck'

    コンパイラで配列の境界の問題をチェックするかどうかを指定します。

    注: cmpoptが'all'または'none'に設定されている場合、noguardcheckが設定されます。
  • 'misscheck' | 'nomisscheck'

    データの欠損値をチェックするかどうかを指定します。

  • 'precise' | 'noprecise'

    演算境界で例外を処理するにはpreciseを指定します。ステートメントの境界で例外を処理するにはnopreciseを指定します。

• 'all'

  コンパイラがnoextramath、nomisscheck、noprecise、noguardcheck、nofuncdifferencing最適化の値を使用して機械言語コードを最適化するように指定します。

  注: 'all'を他の値とともに指定することはできません。
• 'none'

  コンパイラがextramath、misscheck、precise、noguardcheck、funcdifferencing最適化の値を使用して機械言語コードを最適化するように設定されないように指定します。

  注: 'none'を他の値とともに指定することはできません。

cas.cmpopt='extramath misscheck precise'

並べ替えの照合順序を指定します。

mvaでは、SASクライアントの照合が指定されます。ucaでは、ロケールに適した照合順序が指定されます。

cas.collate='mva'

SASのFMTERRに相当します。出力形式が使用できない場合のDATAステップの反応を指定します。trueの場合、DATAステップはエラーを書き込み、停止します。falseの場合、DATAステップは、使用できない出力形式のかわりに$w.またはBEST12.を使用します。(使用できない出力形式は、出力テーブルの変数に関連付けられたままです。)

cas.datastepfmterr=false

DATAステップメッセージの要約レベルを指定します。DATAステップが複数のスレッドで実行されている場合、各スレッドで同じメッセージを生成できます。このオプションでは、重複メッセージの要約レベルが制御されます。

• 'all'

  すべてのメッセージとputステートメントのうちで最初に発生したものが、発生時にクライアントに送信されます。重複して発生したメッセージとputステートメントはすべて要約され、DATAステップが終了するとクライアントに送信されます。これがデフォルトです。

• 'none'

  すべてのスレッドからのすべてのメッセージとputステートメントがクライアントログに書き込まれます。要約は行われません。

• 'put'

  すべてのメッセージとputステートメントのうちで最初に発生したものがクライアントに送信されます。重複して発生したメッセージは要約され、DATAステップが終了するとクライアントに送信されます。putステートメントは要約されるず、発生時にクライアントに送信されます。

cas.datastepmsgsumlevel='none'

DATAステップが既存のテーブルを置換できるかどうか指定します。

cas.datastepreplacetable=true

dataStepMergeNoByパラメーターを指定します。BYステートメントなしでマージが実行される場合、このパラメーターで、警告なし、警告あり、エラーメッセージ生成のいずれにするかが決定されます。

• ERROR

  BYステートメントがない場合、マージが実行されず、エラーメッセージが生成されることを指定します。

• NOWARN

  BYステートメントがない場合、警告メッセージなしでマージが実行されることを指定します。

• WARN

  BYステートメントがない場合、警告メッセージありでマージが実行されることを指定します。

CASがCASノードマシン名をSAS Embedded Processに送信する方法を指定します。cas.DCHOSTNAMERESOLUTIONは、SAS Embedded Processをサポートするすべてのデータストアで有効です。

• 'ep'

  CASノードマシン名を、cas.hostsでの定義どおりにSAS Embedded Processに送信します。SAS Embedded Processは、IPv4またはIPv6を使用して名前を解決します。

• 'ep_fqdn'

  CASノードマシン名を完全修飾ドメイン名としてSAS Embedded Processに送信します。SAS Embedded Processが名前を解決します。

• 'cas'

  (デフォルト) CASノードマシン名をIPv4アドレスとしてSAS Embedded Processに送信します。

• 'cas_ipv6'

  CASノードマシン名をIPv4またはIPv6アドレスとしてSAS Embedded Processに送信します。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

cas.dchostnameresolution='ep'

5文字のSAS Quality Knowledge Base (QKB) ISOロケールコードを使用して、データ品質(DQ)操作に使用するデフォルトロケールを指定します。

詳細については、QKB Locale ISO Codesを参照してください。

cas.DQLOCALE='FRCAN'

データ品質(DQ)操作に使用するデフォルトのSAS Quality Knowledge Base (QKB)の名前を指定します。

QKB-nameは、SAS Environment ManagerでQuality Knowledge Basesの名前列に表示される名前です。

cas.DQSETUPLOC='QKB CI 32'

カスタム日付イベントを定義する1つ以上のイベントオブジェクトを指定します。

event-data-setでは、イベント定義を含むデータセットの名前が指定されます。1レベル名または2レベル名(libref.datasetなど)を使用できます。複数の名前を指定する場合は、各名前をスペースで区切ります。

event-data-setは単一引用符で囲みます。

cas.eventds='mydataset'

セッションの起動時に自動的に設定されるフォーマット検索リストを指定します。

サーバー構成ファイルを使用して、サーバーの起動時に共通フォーマットライブラリを追加およびプロモートできます。プロモーションにより、すべてのセッションでフォーマットライブラリを使用できるようになります。

セッションの起動時に、cas.FMTSEARCH値を使用して、setFmtsearchアクションを生成および実行します。setFmtsearchアクションは、フォーマットライブラリが検索される順序を指定します。テーブル変数には、ユーザー定義出力形式を関連付けることができます。テーブルの処理中に、ユーザー定義出力形式を適用する必要がある場合、CASはsetFmtsearchアクションによって確立されたフォーマットライブラリのリストを検索します。

cas.fmtsearch='myformatsA myformatsB'

SAS Embedded Processで使用するためにSingleStoreにパブリッシュされたフォーマットライブラリのフォーマット検索リストを指定します。

• caslib.tablename

  SingleStoreデータベースのcaslibとテーブルを指定します。テーブルには、以前にパブリッシュされたフォーマットライブラリが含まれています。テーブルごとにcaslibが必要です。caslibおよびテーブル名に空白スペースを含めることはできません。複数のテーブルを指定する場合は、各caslib.tablenameをスペースで区切ります。

このオプションは、SingleStoreデータコネクタに有効です。その場合、WHERE式と計算列は、SingleStoreデータベースでSAS In-Database Technologiesによって、SAS Embedded Processを使用して処理されます。

WHERE式または計算列にユーザー定義出力形式が含まれている場合は、sessionProp.saveFmtLibアクションを使用して、フォーマットライブラリをSingleStoreデータベーステーブルとして保存する必要があります。次に、S2FORMATSEARCH=セッションオプションまたはcas.S2FORMATSEARCH=サーバーオプションを設定して、出力形式を含む1つ以上のデータベーステーブル名をリストする必要があります。

cas.s2formatsearch="singlestorelib.myfmtlib"

コントローラーとそのワーカーノード間の通信のために分散サーバーで使用されるネットワークポートを指定します。

一般的に構成されているポートは5580です。

cas.gcport=5580

SAS Cloud Analytic ServicesがHTTP通信をリッスンするポート(またはポートの範囲)。

一般的に構成されているポートは8777です。

cas.httpport=8777

cas.httpport=8777-9000

SAS Cloud Analytic ServicesがHTTP通信をリッスンする最大ポート範囲を指定します。

cas.httpport=8777-9000

1つ以上のinterval-name=valueペアを指定します。値は、ユーザー定義の間隔を含むデータセットの名前です。

cas.intervalds='subsid1=subsid.storeHours'

CASコントローラーに対して、サーバーの起動に使用されるX.509デジタル証明書ファイルへのパスとファイル名を識別します。証明書は、CASサーバーによって信頼されているCAによって署名されている必要があります。

pathnameは単一引用符で囲みます。

cas.keyfile='/opt/TKGrid/certs/controller.pem'

並べ替えおよびフォーマットに使用するロケールを指定します。有効なPOSIXロケール文字列のリストについては、ロケールからエンコーディングへのマッピング (SAS各国語サポート(NLS): リファレンスガイド)を参照してください。

cas.locale='fr_FR'

SASログ機能のログ構成ファイルへのパスを指定します。

pathnameは単一引用符で囲みます。

cas.logcfgloc='/opt/sas/cas1/etc/logconfig.xml'

ログのフラッシュ時間をミリ秒単位で指定します。

• -1

  各アクションの完了後にログをフラッシュします。

• 0

  ログが生成されるときにフラッシュします。

• number

  numberミリ秒でログをフラッシュします。

cas.logflushtime=500

同時セッションの最大数を指定します。管理者の役割を引き受けることができるユーザーは、制限に依存しません。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

cas.maxsessions='1000'

テーブルに割り当てる物理メモリの最大量を指定します。

• number

  テーブルに割り当てる物理メモリの最大量をバイト単位で指定します。

• '[number k | m | g | t]'

  バイト以外の単位でテーブルに割り当てる物理メモリの最大量を指定します。この単位には、k (キロバイト)、m (メガバイト)、g (ギガバイト)、t (テラバイト)があります。

cas.maxtablemem='32m'

ログメッセージのレベルを指定します。

cas.messagelevel='default'

CASサーバーのメトリック情報をSASログで表示(true)または非表示(false)にします。

cas.metrics=trueの場合、SASログに次のような情報が表示されます。

NOTE: Action 'nobs' used (Total process time):
NOTE:       real time               2.100185 seconds
NOTE:       cpu time                0.010999 seconds (0.52%)
NOTE:       total nodes             6 (192 cores)
NOTE:       total memory            1.11T
NOTE:       memory                  7.00K (0.00%)
The analytic server processed the request in 2.100185 seconds.

cas.metrics=false

このセッションに関連付けられているワーカーノードの数を指定します。

cas.nworkers=8

CASサーバーがアクセス許可を保存するディレクトリへのパスを指定します。

pathは単一引用符で囲みます。

サーバーは、定期的およびシャットダウン時に、そのcaslibおよびアクセスコントロール情報をcas.PERMSTOREディレクトリに保存します。

その後サーバーが起動するたびに、caslibおよびアクセスコントロール情報がサーバーのcas.permstoreの場所から初期化されます。

CASサーバーがリッスンするポートを指定します。

最大許容ポート番号は65535です。有効なポートが指定されていない場合、サーバーはTCP/IP一時ポート範囲を通じてオペレーティングシステムによって選択されたポートでリッスンします。一般的な範囲は32768-61000です。

一般的に構成されているポートは5570です。

cas.port=5570

サーバーがクライアント接続を受け入れる前にCASサーバーが実行する構成ファイルを指定します。この起動ファイルには、サーバーの起動時にサーバーが実行するCASアクションが含まれています。

cas.startup='casstartup.lua'

SAS Cloud Analytic Services起動ディレクトリの場所を指定します。

cas.startupdir='/cas/config/my_cas_startup'

次のいずれかのシナリオでフェイルオーバーのために作成される追加のブロックコピーの数を指定します。

cas.subsetsessioncopies=3

プロセスリストなどのオペレーティングシステムに表示されるCASサーバーインスタンスを指定する文字列を指定します。

cas.TAGオプションは、CASのデバッグ時に役立ちます。

変数を設定するには、sas.cas.instance.config:configインスタンスを編集します。

cas.tag='cas-my_tag'

27019 ?        00:00:01  cas-my_tag 

セッションの新しいテーブルにデフォルトのレプリケーション係数を指定します。

また、sas.cas.instance.config:configインスタンスを編集して、変数を設定することもできます。

cas.DEFAULTTABLEREPLICATION=3

CASサーバーのデフォルトのタイムゾーンを指定します。

'time-zone-name'は、3文字または4文字のタイムゾーン名を指定します。たとえば、ESTは東部時間のタイムゾーン名です。

'time-zone-ID'は、SASによって定義された地域または領域の値を指定します。タイムゾーンIDを指定すると、CASセッションが使用するタイムゾーンは、タイムゾーン名と夏時間ルールによって決まります。

また、sas.cas.instance.config:configインスタンスを編集して、変数を設定することもできます。

cas.TIMEZONE='Europe/Paris'

cas.TIMEZONE='PDT'

CASサーバー内のワーカー数が増加したときに適用されるテーブル再配布ポリシーを指定します。

NOREDIST: 実行中のCASサーバー上でワーカーポッドの数が変更された場合に、テーブルデータが再配布されないことを指定します。

REBALANCE: 実行中のCASサーバー上でワーカーポッドの数が変更されたときにテーブルデータがリバランスされることを指定します。

また、sas.cas.instance.config: configインスタンスを編集して、変数を設定することもできます。

CASサーバーに対応するCASDeploymentカスタムリソース内のspec.workersの値を減らすことによって、ワーカーポッドがCASサーバーから正常に削除されるときに、グローバルテーブル内でデータがどのように移動されるかを指定します。

SUSPEND: グローバルテーブル内のデータが他のワーカーポッドに移動されているときに、すべてのサーバーアクティビティが一時停止されます。データの移動中は、新しいアクションは開始されず、新しい接続は受け入れられません。

BACKGROUND: 各グローバルテーブルはロックされ、スケールダウンされていないワーカーポッド上のデータを含むテーブルのコピーが作成されます。コピーが完了すると、元のテーブルが削除され、コピーに置き換えられます。この操作中に、アクションはロックされたテーブルを読み取ることができますが、ロックされたテーブルを変更しようとするアクションは、コピーが完了するまで待機する必要があります。

また、sas.cas.instance.config: configインスタンスを編集して、変数を設定することもできます。

ワーカーごとのコアの最大数を指定します。

MAXCORESPERWORKER=0の場合、オーバースレッド処理によるパフォーマンスの低下を減らすために、システムはコンテナーのコア制限を適用します。MAXCORESPERWORKER=がゼロ以外の値に設定されている場合、コアの数はその値に制限されますが、その上限はコンテナーのCGroupコア制限となります。ワーカーごとのコアの最大数を減らすと、コアの競合が削減され、パフォーマンスが向上する可能性があります。これは、複数のユーザーがCASサーバー上で高度な同時アクションを実行している場合に特に当てはまります。このオプションを指定すると、CASサーバー上のすべてのセッションのデフォルトの最大値を変更できます。セッションオプションMAXCORESPERWORKER=を使用すると、1つのセッションのワーカーごとの最大コア数を変更して、そのセッションのみのパフォーマンスを向上させることができます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

cas.maxcoresperworker=7

新規または既存のセッションのSAS Cloud Analytic Servicesセッションタイムアウトを秒単位で指定します。

cas.timeout=100

新しいセッションが作成されるときのセッションテーブル再配布ポリシーオプションの初期(デフォルト)値を指定します。

DEFER: 再配布ポリシーの選択が上位レベルのエンティティに従うことを指定します。

NOREDIST: 実行中のCASサーバー上でワーカーポッドの数が変更された場合に、テーブルデータが再配布されないことを指定します。

REBALANCE: 実行中のCASサーバー上でワーカーポッドの数が変更されたときにテーブルデータがリバランスされることを指定します。

また、sas.cas.instance.config: configインスタンスを編集して、変数を設定することもできます。

新しいサーバーに転送できる単一セッションの最大結合テーブルサイズを決定します。指定された量を超えるデータを持つセッションでは、すべてのセッションテーブルが新しいサーバーに転送されるわけではありません。SAS管理者は、中断を最小限に抑えるためにサイズに制限を設けることができます。デフォルト値は制限なしで、-1で表されます。

また、sas.cas.instance.config: configインスタンスを編集して、このオプションを設定することもできます。

cas.MAXSESSIONTRANSFERSIZE=1000000000

状態を新しいサーバーに転送する方法を決定します。

SUSPEND: グローバルテーブルの転送中にアクションは実行できません。

READONLY: グローバルテーブルの転送時に、すべてのグローバル状態情報(CASLIBSやアクセス許可など)を'readonly'にマークします。グローバル状態を変更するアクションを実行しようとすると、失敗します。

セッションテーブルの転送中はサーバーが使用できません。グローバル状態が保存された後、サーバーは実行中のすべてのセッションがアクション境界に達するまで待機します。

また、sas.cas.instance.config: configインスタンスを編集して、このオプションを設定することもできます。

cas.STATETRANSFERMODEL=READONLY

CASサーバーが、セッションの起動時に、指定された場所に各ユーザーのパーソナルcaslibを作成することを指定します。

'%HOME'はユーザーのオペレーティングシステムの$HOMEディレクトリに相当します。

'pathname/%USER'は、指定されたファイルシステムパスの下にある、ユーザーのユーザーIDに基づいて名付けられたディレクトリを指します。%USERが常にオプション値に指定されたパスの最後に配置されていることを確認してください。

pathnameは単一引用符で囲みます。

cas.userloc='%HOME'

cas.userloc='/local/%USER'

CASサーバーのデフォルトメモリ形式を指定します。

• STANDARD: 標準メモリ形式を使用するように指定します。標準メモリ形式はパフォーマンスを最適化するために設計されています。このオプションのデフォルトです。
• DVR: 重複値削減メモリ形式が使用されるように指定します。入力データに多数の重複値が含まれる場合、DVRメモリ形式を使用すると、メモリ消費量とSASHDATファイルのオンディスクサイズを削減できます。

また、sas.cas.instance.config: configインスタンスを編集して、変数を設定することもできます。

BIGINTのサポートを有効にするかどうかを指定します。

SASでは、デフォルトで、整数値はプロシジャとアクションで計算のほとんどを実行する前に、DOUBLE値に強制変換されます。15–16桁以上の大きな整数値の場合、この変換により精度が失われる場合があります。

cas.BIGINTPROCESSING=TRUEの場合、これらの選択されたCASアクションは強制をバイパスし、完全な精度でBIGINT値を保持します。

cas.BIGINTPROCESSING=FALSEの場合、デフォルトのDOUBLEセマンティクスが適用されます。

builtins.historyアクションが実行されるときに、アクション名とアクションパラメーターをレポートするために使用するバイト数を指定します。

指定した場合、HISTORYLINELENセッションオプションはCASACTIONHISTORYLEN環境変数よりも優先されます。

アクション要求がアクション履歴行の長さよりも長い場合は、切り捨てられます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

アクションが実行されるときに、アクション名とアクションパラメーターをサーバーログに記録するために使用するバイト数を指定します。

最大値は32768です。

アクション要求がログ行の長さよりも長い場合は、切り捨てられます。

デフォルトの長さは1024です。ログレベルが設定されている場合、デフォルトの長さに影響する場合があります。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

指定すると、CASセッションが要求元ユーザーのホストIDで実行されます。この環境変数は、各ユーザーが個々のホストIDでCASセッションを起動する配置を対象としています。この環境変数では、すべてのユーザーを CASHostAccountRequiredグループに割り当てるかわりに、メンテナンスの手間が少ない方法が提供されます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

• CASALLHOSTACCOUNTSが指定されている場合は、CASHostAccountRequiredグループの存在とメンバーシップよりも優先されます。たとえば、CASALLHOSTACCOUNTSが指定されている場合は、CASHostAccountRequiredグループが存在し、メンバーが1つだけであっても、すべてのユーザーがホストIDでCASセッションを起動します。
• CASALLHOSTACCOUNTSが指定されていない場合は、CASHostAccountRequiredグループのメンバーであるユーザーのみが、ホストIDでCASセッションを起動できます。

デフォルトでは、CASはユーザーのホストIDでセッションを起動できません。CASのホスト起動を有効にするには、Enable Host Launch (SAS Viya Platform: Deployment Guide)を参照してください。

値1で指定すると、CASセッションがOS IDで起動される場合(ユーザーがCASHostAccountRequiredグループのメンバーである場合)、IDサービスを使用して標準Cライブラリ関数のかわりにPOSIX属性をフェッチします。

デフォルトでは、CASCLOUDNATIVEは有効になっています。CASCLOUDNATIVEを無効にするには、値を0に設定する必要があります。

ユーザーのホームディレクトリは、config/identities/sas.identities/identifier.homeDirectoryPrefix構成変数が配置で設定されている場合、IDサービスから使用できます。構成変数が設定されていない場合、ユーザーのホームディレクトリは、userlocオプションで設定された場所にデフォルト設定されます。(デフォルトの場所: /cas/data/caslibs/casuserlibraries)

管理者は、CASのユーザー定義出力形式に対して特定の操作を実行しようとするユーザーに対して、管理用認証情報のチェックをオンまたはオフにできます。

env.CAS_ADMIN_GLOBAL_UDFMTS=YES|ON|TRUEの値は、グローバルのユーザー定義のフォーマットライブラリをプロモートまたは削除するために、スーパーユーザーへの管理用権限のエスカレーションが必要であることを指定します。

env.CAS_ADMIN_GLOBAL_UDFMTS=NO|OFF|FALSEの値は、これらの操作を実行するために、スーパーユーザーへの管理用権限のエスカレーションが不要であることを指定します。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

Amazon S3などの特定のクラウドプラットフォームにCSVファイルを保存するときや、CAS uploadアクションのために、CASコントローラーノードにデータを一時的に保存するためのディスクパスを指定します。

複数のパスはコロン(:)で区切ります。

env.CAS_CONTROLLER_TEMP = '/upload_data/disk1:/upload_data/disk2'

デフォルトパス/cas/dataのかわりに製品caslibsの代替パスを指定します。これにより、ユーザーはパブリックcaslibを使用して、指定された場所からデータを読み書きできるようになります。

CASDATADIRは、cas-default-data永続ボリューム(PV)がマウントされているディレクトリを指します。cas-default-dataはデフォルトのCASデータPVです。

このオプションは、高性能ストレージプラットフォームを指すように構成することをお勧めします。/cas/dataのバッキングボリュームは、CAS配置のポッドがリセットされたときにこのデータを維持するために永続ボリュームの要求としてプロビジョニングする必要があります。

CASデータディレクトリには、プライマリおよびセカンダリCASコントローラーからのみアクセスできます。

ユーザーは別のディレクトリを指定して一時ユーティリティファイルを作成し、デフォルトの/tmpディレクトリがいっぱいになるのを避けることができます。

デフォルトでは、一時ファイルは/tmpに保存されます。別のディレクトリを使用するには、管理者はCASサーバーを起動する前に、この環境変数を必要なディレクトリに設定する必要があります。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.TKUTILLOC='myDir/UtilityFiles'

メモリ形式がDVRに設定されている場合、サーバーは重複値削減(DVR)メモリ形式を使用します。メモリにロードして分析するデータに多くの繰り返し値がある場合、DVRメモリ形式により、テーブルのインメモリサイズとSASHDATファイルのディスク上のサイズを削減できます。標準メモリ形式は、高性能を目的として設計されており、モデリングで一般的なように、入力データに一意の値を持つ多数の数値変数が含まれている場合に適切に機能します。

CASワーカーノードのデータをキャッシュするディスクパスを指定します。

複数のパスはコロン(:)で区切ります。

env.CAS_DISK_CACHE = '/data/disk1:/data/disk2'

サポートされているデータソースで、サポートされているデータ形式を使用してサーバーがメモリマッピングを実行する方法を指定します。

• CASDISKCACHE

  インメモリテーブルのブロックのコピーを作成することを指定します。ブロックは、サーバーの起動時にCAS_DISK_CACHE環境変数によって識別されるディレクトリに保存されます。

• INPLACEPREFERRED

  メモリマッピングに既存のSASHDATファイルのブロックを使用するように指定します。既存のブロックを使用できない場合は、CASDISKCACHEに説明されているように、ブロックのコピーが使用されます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

セッションに使用されるSASロケールデータバージョンを指定します。SASロケールデータバージョンのデフォルト値は、SAS 9と互換性のあるレガシーSASロケール日付バージョンです。

• COMPAT (デフォルト): SAS 9と互換性のあるレガシーSASロケールデータを使用します。
• CLDR: CLDR (Common Locale Data Repository)データを使用します。このデータのバージョンは、CLDRの新しいリリースに対応するために定期的に更新されます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.SAS_LOCALE_DATA='CLDR'

CASワーカーノードから最後のハートビートを受信してから、コントローラーがノードを失われたものとして扱うまでの間隔(秒単位)を指定します。

間隔が短いほど、警告なしにネットワークを離れるマシンがより早く検出されます。間隔が長いほど、例外的に過負荷になる可能性のあるマシンに対してより耐性が上がります。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.CAS_HEARTBEAT_LOST_TIMEOUT='300'

指定すると、SAS Configuration Server (Consul)との通信をオンにして、CASリソース管理ポリシーを有効にします。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.CAS_ENABLE_CONSUL_RESOURCE_MANAGEMENT='true'

システム内のユーザー名と一致する各ユーザーのホームディレクトリが作成されるディレクトリの場所を指定します。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.CASHOMEDIRLOC='/home'

'/home/user01'

CASマシンのホームディレクトリのアクセス許可モードを指定します。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.CASHOMEDIRPERMS=750

ユーザーがセッションを開始したときにホームディレクトリが見つからない場合、CASマシンにホームディレクトリを作成します。

• CONTROLLER

  プライマリコントローラーマシンのみにホームディレクトリを作成します。

• WORKER

  プライマリコントローラーおよびワーカーマシンにホームディレクトリを作成します。

• BACKUP

  プライマリコントローラーおよびバックアップコントローラーにホームディレクトリを作成します。

• ALL

  すべてのノードにホームディレクトリを作成します。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.CASPWFORCEHOST=trueの場合、(ユーザー名とパスワードを使用して) CASに直接接続するユーザーのCASセッションは、ユーザーのOS IDで実行されます。

指定され、サーバーがパスワード認証プロバイダーで構成されている場合、CASHostAccountRequiredグループのユーザーのみがパスワード認証プロバイダーに対して認証されます。この環境変数を有効にすると、次の利点があります。

• SAS Logon Managerへのユーザー名とパスワードでの認証ができるユーザーは、サービスアカウントでCASセッションを開始できます。
• CASHostAccountRequiredグループのメンバーであるユーザーは、ホスト資格情報を使用してCASセッションを開始できます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

SAS Viyaプラットフォームでバイナリポートを使用して、SAS 9クライアントまたはSAS Viya 3.xクライアントからCASサーバーに直接、Kerberos接続を試みるとき、デフォルトのサービスプリンシパル名の"sascas@FQDN"はSAS Viyaプラットフォーム値の"HTTP/FQDN"に置き換える必要があります。ここで、FQDNは、Kubernetesクラスターのプライマリノードの完全修飾ドメイン名です。

クォータがすべてのテーブルに適用されることを指定します。

この変数が設定されていないか、他の値に設定されている場合、CAS_DISK_CACHEからのみマッピングされるテーブルは、クォータ制限に対してカウントされます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

SASLogonでユーザー名とパスワードを認証するときに、ユーザー名の一部である@domainを削除します。

この環境変数は、ホスト認証には“user@domain”形式のユーザー名が必要で、LDAP認証にはSASLogonで@domain部分のない“user”形式のユーザー名が必要な場合に、ホスト認証とLDAP認証の不一致を解決するのに役立ちます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

'user01'

有効な場合(任意の値を使用して指定)、CASサーバーは、認証、グループルックアップ、およびプロセスの起動中に、ユーザー名の大文字と小文字の区別を無視します。SASテクニカルサポートからの指示がない限り、env.CASUSERIGNORECASEを指定するときは常にenv.CASUSERLOWERCASEを指定してください。

env.CASUSERIGNORECASEを宣言する一般的なシナリオは、ユーザーが自分のホストアカウントでCASセッションを実行するときに、ユーザー認証システムが大文字と小文字を区別しないように構成され、大文字または大文字と小文字が混在するユーザー名が含まれる場合です。詳細については、The CASHostAccountRequired Custom Group (SAS Viya Platform: Identity Management)を参照してください。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.CASUSERIGNORECASE='on'

有効な場合(任意の値を使用して指定)、CASサーバーはユーザー名を小文字に変換します。env.CASUSERLOWERCASEは通常、env.CASUSERIGNORECASEと組み合わせて使用されます。

env.CASUSERLOWERCASEを宣言する一般的なシナリオは、ユーザーが自分のホストアカウントでCASセッションを実行するときに、ユーザー認証システムが大文字と小文字を区別するように構成され、大文字または大文字と小文字が混在するユーザー名が含まれる場合です。詳細については、The CASHostAccountRequired Custom Group (SAS Viya Platform: Identity Management)を参照してください。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.CASUSERLOWERCASE='on'

カンマで区切られた有効な発生元のリストを指定し、CORSポリシーのallowlistに追加します。アスタリスク(*)を指定して、有効な発生元に一致させることもできます。

有効な発生元は、ホスト名またはIPアドレスを含む次の形式になります。

scheme://hostname:[\{_}port\{_}]

scheme://ipAddress:[\{_}port\{_}]

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.TKHTTP_CORS_ALLOWED_ORIGINS='http://support.sas.com,https://internal.companysite.com:442'

クロスサイトスクリプティング(XSS)攻撃を防ぐために使用されるコンテンツセキュリティポリシー(C-S-P)ヘッダーを指定します。

env.TKHTTP_CONTENT_SECURITY_POLICYが設定されていない場合、次のデフォルトのC-S-Pヘッダーが使用されます。

Content-Security-Policy: default-src 'self';script-src 'self' 'unsafe-inline' 'unsafe-eval';
style-src 'self' 'unsafe-inline';frame-ancestors 'none';object-src 'none';connect-src 'self';
img-src 'self';base-uri 'self';form-action 'self';require-trusted-types-for 'script';

env.TKHTTP_CONTENT_SECURITY_POLICYが何らかの値に設定されている場合、この値はC-S-Pヘッダーとして提供される他の値よりも優先されます。

env.TKHTTP_CONTENT_SECURITY_POLICYが空の文字列""に設定されている場合、C-S-Pヘッダーは使用されません。

この環境変数により、SAS管理者は自動調整のレベルを制御できます。

• none

  すべての自動調整アクションは、次のエラーメッセージを表示し、実行を停止します。Auto-tune is not allowed for this environment.

• sequential

  すべての自動調整アクションは、ユーザーが並列実行を要求したかに関係なく、構成が順に評価されるようにします。次の警告メッセージがログに表示されます。Auto-tune is limited to sequential execution for this environment.

• parallel

  この環境変数が定義されていない場合、またはparallelオプションを指定すると、自動調整アクションが正常に実行され、使用可能なリソースに応じて並列評価が使用されます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.AUTOTUNING_LEVEL_ALLOWED='sequential'

この環境変数がTRUEに設定されている場合、fedSql.execDirectアクションのすべての呼び出しは、VARBINARY列の最適化を使用して実行されます。このアクションでは、fedSql.execDirectアクションでVARBINARY列を読み取って作成するときに、宣言された最大サイズではなく、列に保存されているVARBINARYデータの最大サイズを使用します。

最適化は、VARBINARY列の宣言されたサイズと実際のサイズに大きな違いがある場合に大きな利益をもたらします。たとえば、VARBINARY列に宣言された最大サイズが16000文字であるが、30文字を超える値が含まれていない場合などです。より小さい精度を使用すると、クエリのパフォーマンスを向上させ、VARBINARY列を持つインメモリテーブルのメモリ消費量を削減することができます。

さらに、FedSQL CREATE TABLE ASを使用して新しいテーブルを作成すると、新しいテーブルのVARBINARY列は、ソーステーブルからVARBINARY精度が伝播するのではなく、必要なサイズで作成されます。もともとソーステーブルでVARBINARY(16000)列であったものを、新しく作成されたテーブルではVARBINARY(30)列にすることができます。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

この環境変数をTRUEに設定すると、VARCHARデータ型に適用されることを除いて、FEDSQL_OPTIMIZE_VARBINARY_PRECISIONと同じ利点があります。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

外部言語アクセスコントロールXML構成ファイルを含むすべてのCASワーカーが使用できるパスを指定します。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

CASアクションおよびプロシジャの実行時に使用される乱数ジェネレーター(RNG)を指定します。

有効なRNGの例は、'PCG' (permuted congruential generator)または'TF2' (2x64ビットカウンターベースのThreefry)です。random-number-generatorの完全な値セットは、CALL STREAMINIT ルーチン (SAS関数とCALLルーチン: リファレンス)にリストされています。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。

env.SAS_RNG_METHOD='PCG'

テキスト分析の実行に必要なSAS言語バイナリファイルのインストールディレクトリを指定します。

変数を設定するには、sas.cas.instance.config: configインスタンスを編集します。bash形式を使用して、sas.cas.instance.config: settingsインスタンスで変数を設定することもできます。

env.TKTXTANIO_BINDAT_DIR='/opt/sas/viya/home/SASFoundation/utilities/TKTGDat'

globalCaslibs
   _ALL_         quota
   [global-caslib  quota]
   [...]

グローバルcaslibを指定します。

global-caslibが使用できるCAS_DISK_CACHE領域の最大量をバイト単位で指定します。

すべてのグローバルcaslibを指定します。

_ALL_ が指定されている場合、quotaでは、テーブルが属するcaslibに関係なく、すべてのグローバルテーブルに使用できるCAS_DISK_CACHE領域の合計量が指定されます。

  globalCaslibs 
     _ALL_      400000000 
     HPS        200000000 
     MyGlobal   100000000 

  [CAS-server-priority-n
          globalCasuser     - quota
          sessionTables     - quota]
  [...]

  priorityAssignments
     user	priority-level
     [...]

  [CAS-server-priority-n
          globalCasuser     - quota
          sessionTables     - quota]

  [...]

CASサーバーを指定します(cas-shared-defaultやcas-tenant1-defaultなど)。

ポリシーの優先順位レベルを指定します。nは1 - 5の数字です。

関連するテーブルカテゴリが使用できるCAS_DISK_CACHE領域の最大量をバイト単位で指定します。

ユーザーのパーソナルcaslib (CASUSER caslib)で定義されているグローバルテーブルのクォータを指定します。

セッションテーブル(MyTableなど)に配置するクォータを指定します。

  globalCaslibs
     _ALL_         quota
     [global-caslib  quota]
     [...]

  priorityLevels
     cas-shared-default-priority-1 
                globalCasuser     - 500000000 
                sessionTables     - 500000000 
     cas-shared-default-priority-2 
                globalCasuser     - 50000000 
                sessionTables     - 50000000 
     cas-shared-default-priority-3 
                globalCasuser     - 10000000 
                sessionTables     - 10000000 

  priorityAssignments
     user	priority-level
     [...]

  priorityAssignments
     user 	priority-level
     [...]

CASリソース管理ユーザーグループ(cas-shared-default-priority-1など)のメンバーではないCASユーザーIDを指定します。

特定のポリシーにマッピングする優先順位レベルを指定します。priority-levelは1-5の数値です。

たとえば、4が指定されている場合、userはcas-shared-default-priority-4ポリシーに割り当てられます。

  globalCaslibs
     _ALL_         quota
     [global-caslib  quota]
     [...]

  [CAS-server-priority-n
          globalCasuser     - quota
     sessionTables     - quota]
  [...]

  priorityAssignments 
     userA	1