Studioのconfiguration.yaml構成ファイル

基本的な構成オプションのためのDataStax Studio構成ファイル。

dse.yaml

dse.yamlファイルの場所は、インストールのタイプによって異なります。
パッケージ・インストール /etc/dse/dse.yaml
tarボール・インストール installation_location/resources/dse/conf/dse.yaml

Studioの構成ファイルは、dse-studio-install-dir/configuration.yamlです。

XML形式でのサンプル構成ファイルは、以下のようになります。
# Maximum number of items returned per cell execution. Additional items will be truncated.
# Unit: count / number of items
resultSizeLimit: 1000

# Maximum size of a cell result. If a cell result exceeds this size then the cell execution will fail.
# Unit: bytes
maxResultSizeBytes: 524288

# Cell execution timeout. A value of 0 indicates no Studio-specific timeout is applied. Instead, 
# use the DSE server timeouts that are configured in dse.yaml.
# Unit: milliseconds
executionTimeoutMs: 0

# Options to configure the Studio web server.
server:
 httpPort: 9091
 # WARNING: Changing the setting from the default (localhost) can pose a security risk as other
 # users on external machines can gain access to notebooks and the DSE clusters those 
 # notebooks are connected to. Studio is designed to be used as a desktop application. 
 # Distributed deployment introduces potential security risks.
 # See http://docs.datastax.com/en/latest-studio/studio/reference/configuration.html for documentation.
 httpBindAddress: localhost

# Studio logging options.
logging:
 fileName: studio.log
 maxLogFileSize: 250 MB
 maxFiles: 10
 directory: ./logs
 # Spark SQL log level
 # 0: Disable all logging
 # 1: Log severe error events that cause the driver to stop
 # 2: Log errors that may allow driver to continue
 # 3: Log events that might results in an error
 # 4: Log general driver progress information
 # 5: Log detailed driver debug information
 # 6: Log all driver activity
 sparkSQLLogLevel: 0

# The path to the local file system where user data is stored.
userData:
  # Defaults to .datastax_studio folder in your home directory, such as  ~/.datastax_studio
  # Set to a non-null value to override.
  baseDirectory: null

  # Time interval between revision saves when only minor changes are made. 
  # For example, revision cell code and settings changes. Major changes, such as executing a cell 
  # and getting a new result, always create a revision history unless the result is identical 
  # to the prior values.
  historySaveFrequencyInSeconds: 300
  # Directory to store notebooks revisions that can be restored.
  historyDirectory: history
  # Enable Gzip compression of history files.
  compressHistoryFiles: true
  # Enable pruning of history revisions. When there are more than "minHistoryRevisionsToKeep"
  # history revisions, revisions older than "maxDaysOfHistoryToKeep" days are deleted.
  pruneRevisionHistoryEnabled: true
  # Maximum number of days to retain history revisions.
  maxDaysOfHistoryToKeep: 30
  # Minimum number of revisions to retain before pruning by date is enforced.
  minHistoryRevisionsToKeep: 25

セル・オプション

resultSizeLimit
セルが実行されるたびに返される項目の最大数。追加の項目ではtruncateが行われます。デフォルト:1000。
maxResultSizeBytes
セルの結果の最大サイズ。セルの結果がこのサイズを超えると、セルの実行は失敗します。デフォルト:10485760。
executionTimeoutMs
セル実行のタイムアウト時間(ミリ秒単位)。値0は、タイムアウトのオーバーライドがないことを示します。DSEサーバーのタイムアウト( dse.yaml ファイルで構成)を使用します。デフォルト:0。

Studio Webサーバー

httpPort
Studioサーバーが実行するポート。デフォルト:9091
httpBindAddress
StudioサーバーがバインドされるIPアドレス。デフォルト:127.0.0.1

ロギング・オプション

fileName
ログ・ファイルの名前。デフォルト:studio.log。
maxLogFileSize
デフォルト:250 MB。
maxFiles
ログ・ファイルの最大数。デフォルト:10。
directory
ログ・ファイルが格納されるディレクトリーのパス。デフォルト:/log。
sparkSQLLogLevel
Spark SQLのログ・レベル。デフォルト:0

ユーザー・データ

ユーザー・データが格納されているローカル・ファイル・システムのパス。

baseDirectory
デフォルトは、ホーム・ディレクトリーの.datastax_studioフォルダー(~/.datastax_studioなど)です。オーバーライドするNull以外の値に設定されます。デフォルト:null
historySaveFrequencyInSeconds
小さな変更を行う場合、あるリビジョン保存と次のリビジョン保存の間の間隔。小さな変更には、リビジョン・セル・コードおよび設定の変更などがあります。セルの実行や新しい結果の取得といった大きな変更を行うと、結果が以前の値と同じにならない限り、必ず、リビジョン履歴が作成されます。デフォルト:「300」です。
historyDirectory
復元できるノートブック・リビジョンを格納するディレクトリー。デフォルト: ~/.datastax_studio/history
compressHistoryFiles
履歴ファイルのGzip圧縮を有効にします。デフォルト:true
pruneRevisionHistoryEnabled
履歴リビジョンの削除を有効にします。履歴リビジョンの数がminHistoryRevisionsToKeepを超えた場合、maxDaysOfHistoryToKeepの日数より古い履歴は削除されます。デフォルト:true
maxDaysOfHistoryToKeep
履歴リビジョンを保持する最大日数。デフォルト:30
minHistoryRevisionsToKeep
日付別の削除が強制的に行なわれるまでに保持する最大リビジョン数。デフォルト:25