データファイルの管理

Qlik Cloud Analytics では、 [スペースの詳細] > [データファイル] からスペース内のデータファイルを管理できます。データファイルの管理には、名前の変更、複製、移動、削除、新しいデータファイルの追加が含まれます。

このヘルプトピックでは、スペース内のデータファイルを管理するためのインターフェイスに焦点を当てています。このインターフェイスに移動するには、カタログ内のスペースを開き、 [スペースの詳細] > [データファイル] をクリックします。

ツールバー、パスセレクター、テーブルを含む「データファイル」インターフェイス全体を示す画像 — スペース内のデータファイルを管理するための [データファイル] インターフェイス

スペース内のフォルダー構造

Qlik Cloud Analytics 内の各スペースには、階層的に整理された独自のフォルダー構造が含まれています。データファイルは、ネストされたフォルダーの構造で整理できます。たとえば、個人スペース内に注文データと予算データ用の別々のフォルダーを用意する必要がある場合があります。

スペース内のファイルまたはフォルダーの場所は、そのパスに表示されます。パスでは、フォルダーが他のフォルダー内にネストされているかどうかを表すために / シンボルが使用されます。

たとえば、個人スペース内に Order Data と Budget Data の別々のフォルダーがあるとします。Order Data フォルダーに Orders_2024_December.QVD という名前のデータファイルがある場合、このファイルは個人スペース内の次のフォルダーパスにあります。

個人用/Order Data

適用可能なスペースタイプ

次の種類のスペースで、データファイルを階層的なフォルダー構造で整理できます。

個人スペース
共有スペース
管理スペース
データスペース

Qlik Cloud Analytics のスペース

Qlik Cloud Analytics では、個人、共有、管理スペース内のデータファイルを階層的なフォルダー構造で整理できます。

データ統合のスペース

[データスペース] は通常、データ統合プロジェクトからの出力ファイルを保存するために使用されます。データスペース内のデータファイルは分析に使用できます。Qlik Cloud Analytics と Qlik Talend Data Integration から、データスペース内のデータファイルを階層的なフォルダー構造で整理できます。ただし、データスペース内のデータファイルは、分析で使用する目的でのみ、ネストされたフォルダーに再編成する必要があることに注意してください。データパイプラインから生成されたデータファイルがデータスペース内のフォルダーに再配置されると、パイプラインが再度実行されるたびに、ファイルはスペース内の最上位パス (ネストされたフォルダーではなく) に保存され続けます。

Qlik Talend Data Integration 内の個人スペースの動作は、データスペースの場合と同じです。

スペース内のデータファイルを検索する。
所有者別にファイルをフィルタリングする。
ファイルをアップロードする。

スペースにデータファイルを追加する
フォルダーを作成する。

スペースにフォルダーを作成する
一度に複数のデータファイルに対してアクションを実行する。

複数のファイルとフォルダーに対するアクションの実行
ビュー内のファイルとフォルダーの並べ替えを変更する。

既定の [最終更新日] オプションから並べ替えを変更し、 (昇順) と (降順) の順序を切り替えます。
ビュー内のファイルとフォルダーの外観を変更する。

階層ビューの場合はを選択します。階層ビューでは、ファイルとフォルダーがインデントされて階層が視覚的に表示されます。階層ビューで、特定のファイルまたはフォルダーに対してアクションを実行するには、スペースを選択または展開する必要があります。

リストビューの場合はを選択します。リストビューでは、ファイルとフォルダーがテーブル内にフラットな構造で表示され、別の列に特定のパスが表示されます。

パスセレクター

パスセレクターには、現在開いているフォルダーが表示されます。階層リンクにはフォルダー階層が表示されます。パスセレクターでフォルダーを選択すると、現在のパスを基準にして前方または後方に移動します。現在のパスの後の空の領域を選択すると、現在の位置に含まれるフォルダーが表示され、フォルダーを検索できます。

テーブル

テーブルには、スペース内のすべてのファイルとフォルダー、またはスペース内で選択したフォルダーが表示されます。テーブルは、データファイルとフォルダーを管理する場所です。テーブル内のフォルダーを選択して、パスセレクターでフォルダーに移動します。

テーブルでは、サイズ、フォルダーの数、最終更新日時、所有権など、アイテムに関する重要な情報も表示できます。

「データファイル」インターフェイスのテーブル。スペース内の現在選択されているパスに含まれるすべてのデータファイルとフォルダーが表示されます。 — [データファイル] インターフェイスのテーブル

スペースにフォルダーを作成する

フォルダーを作成して、好きな方法でコンテンツを整理します。

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
[データファイル] ウィンドウ内のツールバーで、をクリックします。
フォルダーの名前を定義します。
[パス] では、スペースのフォルダー構造内のどこに新しいフォルダーを追加するかを選択できます。
パスバーをクリックし、ドロップダウンメニューからフォルダーを選択します。または、フォルダーを追加する特定の場所のパスを入力します。
[作成] をクリックします。

または、テーブル内の既存のフォルダーの横にある 3 つのドットのメニューをクリックし、 [フォルダーを追加] を選択してフォルダーを追加します。新規フォルダーが既存のフォルダー内に追加されます。

Store ステートメントで参照されると、フォルダーもスペース内に自動的に作成されます。「アプリおよびスクリプト開発におけるスペースフォルダー構造の参照」を参照してください。

複数のファイルとフォルダーに対するアクションの実行

ツールバーのオプションを使用すると、一度に複数のファイルまたはフォルダーに対して次のアクションを実行できます。

(切り取り)
(コピー)
(貼り付け)
(削除)

スペース間で、または同じスペース内の異なる場所に、アイテムの切り取り、コピー、貼り付けができます。たとえば、複数のアイテムを切り取り、別のスペースに貼り付けることができます。

切り取り、コピー、貼り付けのアクションを使用して、データファイルを別の場所に移動できます。ロードスクリプトで参照されるデータファイルのファイルの場所を変更する場合は、新しい場所を反映するようにロードスクリプトを更新する必要があります。詳細については、「ロードスクリプトで使用されるデータファイルを移動することの影響」を参照してください。

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
テーブルで、アクションを実行するアイテムを選択します。
ヒントメモ
一度に複数のアイテムを選択するには、最初のアイテムをクリックし、キーボードコマンドとクリックを組み合わせて、さらにファイルを選択します。例:
- Shift キーを押しながら、選択する最後のアイテムをクリックします。これにより、最初のアイテムから最後のアイテムまで、すべてのアイテムが選択されます。
- Ctrl (Windows) または command (macOS) を押しながら、追加アイテムを 1 つずつクリックします。これにより、追加するアイテムが個別に選択されます。
ツールバーでアクションをクリックします。使用可能なアクションはこのセクションの前の部分に記載されています。

スペース間でアイテムを切り取って貼り付ける場合は、新しいスペースを開き、[スペースの詳細] > [データファイル] を開いて [貼り付け] アクションを実行する必要があります。

スペースにデータファイルを追加する

スペースにデータファイルを追加できます。

データファイルは最大 100 GB です。ただし、非常に大きなデータファイル (6 GBを超える) をアップロードする場合、エンジン容量に制約が生じる可能性があります。これらの制約は、QVD ファイルをエンジンにロードするために必要なメモリ使用量のために QVD データファイルで発生する可能性が高くなります。使用可能な容量を増やす方法の詳細については、「大規模アプリのサポート」を参照してください。

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
[データファイル] ウィンドウ内のツールバーで、をクリックしてファイルをアップロードします。
データファイルを [ファイルの追加] ダイアログにドラッグアンドドロップします。

または、[参照] をクリックして、データファイルに移動します。
[パス] では、スペースのフォルダー構造内のどこにファイルを追加するかを選択できます。

ファイルを特定のフォルダーに追加するには、パスバーをクリックし、ドロップダウンメニューからフォルダーを選択します。または、特定のフォルダーのパスを入力します。
[Upload] (アップロード)をクリックします。

または、テーブルのフォルダーの横にある 3 つのドットのメニューをクリックし、 [ファイルをフォルダーにアップロード] を選択します。

データファイルを追加するその他の方法については、「データファイルの追加」を参照してください。

ファイルまたはフォルダーでの、切り取り、コピー、貼り付けアクションの実行

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
テーブルで、ファイルまたはフォルダーの横にあるをクリックします。
[切り取り]、 [コピー]、または [貼り付け] をクリックします。

ヒントメモまたは、ファイルを選択して、Ctrl+C (Windows) や command+C (macOS) などの一般的なキーボードショートカットを使用することもできます。

これらのアクションを一度に複数のファイルやフォルダーに対して実行するには、複数のファイルとフォルダーに対するアクションの実行 を参照してください。

データファイルまたはフォルダーの名前の変更

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
テーブルで、ファイルまたはフォルダーの横にあるをクリックします。
[名前を変更] をクリックします。
新しいファイル名を入力して、[保存] をクリックします。

元のファイル名またはフォルダー名を参照するロードスクリプトはすべて更新する必要があります。

データファイルまたはフォルダーの複製

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
テーブルで、ファイルまたはフォルダーの横にあるをクリックします。
[複製] をクリックします。

データファイルまたはフォルダーの移動

ファイルやフォルダーを移動できます。ファイルやフォルダーは、異なるスペース、または同じスペース内の異なる場所に移動できます。

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
テーブルで、ファイルまたはフォルダーの横にあるをクリックします。
[移動] をクリックします。
[パス] でスペースを選択します。現在のスペースまたは新規スペースのどちらも使用できます。
パスバーを再選択するか、をクリックして、選択済みスペース内の特定のフォルダーを定義します。

または、パスを入力して特定のフォルダーを定義します。
データファイルを移動した後に新しい場所を開くには、 [パスに移動] を選択します。
[移動] をクリックします。

一度に複数のアイテムを移動することもできます。実行するには、 [切り取り] と [貼り付け] のアクションを使用します。「複数のファイルとフォルダーに対するアクションの実行」を参照してください。

ロードスクリプトで使用されるデータファイルを移動することの影響

データファイルをスペース内の新しい場所に移動する場合、そのデータファイルを参照するすべてのロードスクリプトを更新して、新しいファイルパスを参照する必要があります。あるスペースから別のスペースに移動されるファイルにも、同じ考慮事項が適用されます。

たとえば、アプリまたはスクリプトのロードスクリプトが個人スペース内の次のファイルを参照しているとします。

LOAD * FROM [lib://DataFiles/orders.csv];

ここで、データファイルをスペース TeamSharedSpace に移動し、orders.csv をスペース内の Sales Analysis という名前の新しいフォルダーに移動するものとします。orders.csv からデータをロードするすべてのアプリとスクリプトでは、ロードスクリプト内のファイル参照を次のように更新する必要があります。

LOAD * FROM [lib://TeamSharedSpace:DataFiles/SalesAnalysis/orders.csv];

更新しないと、リロードは失敗します。

ロードスクリプトでスペースフォルダーの場所を参照する方法の詳細については、「アプリおよびスクリプト開発におけるスペースフォルダー構造の参照」を参照してください。

データファイルまたはフォルダーの削除

次の手順を実行します。

スペースで [スペースの詳細] をクリックして、 [データファイル] を選択します。
テーブルで、ファイルまたはフォルダーの横にあるをクリックします。
[ 削除] をクリックします。

ヒントメモあるいは、ファイルを選択してキーボードで Delete と入力することもできます。
ダイアログで、 [削除] をクリックし、削除を確定します。

一度に複数のアイテムを削除することもできます。「複数のファイルとフォルダーに対するアクションの実行」を参照してください。

データファイルに対するその他のアクションの実行

[データファイル] インターフェイスでは、特定のファイルの分析を実行するための他のツールに直接移動することもできます。ファイルで 3 つのドットのメニューメニューを使用する場合、次のオプションを使用できます。

影響分析: データセット内のデータに変更を加えた場合の潜在的な影響を調査します。

アプリ、スクリプト、データセットの影響分析の分析
系列: データセットの履歴について詳しく理解します。

アプリ、スクリプト、データセットの系列の分析
データセットを開く: データセットを開くと、ファイルの概要とプロファイル情報にアクセスできます。

データセットメタデータの管理

スペース権限

データファイルは、Qlik Cloud Analytics のデータソースの一種です。

次のいずれかのロールを持つ共有スペースメンバーは、そのスペース内のデータソースを管理できます。

所有者
管理可能
編集可能
App でデータ編集可能

次のいずれかのロールを持つ管理スペースメンバーは、そのスペース内のデータソースを管理できます。

所有者
管理可能
操作可能 (Professional 資格または Full User 資格を使用)

[データ消費可能] の役割を持つスペースメンバーは、スペース内のデータソースを表示でき、アプリを作成する権限がある場所でデータソースを消費できます。

[データ消費可能] の役割は、スペースのメンバーに、そのスペースに格納されているデータソースを表示および消費する権限を与えるスペースレベルの役割です。この役割の利点は、スペース内のデータソースにアクセスするために通常必要となる昇格されたアクセス許可をユーザーに付与せずに、ユーザーがスペース内のデータファイルとデータ接続にアクセスできるようにすることです。

データソースアクションのスペースロール要件の詳細については、次を参照してください。

アプリおよびスクリプト開発におけるスペースフォルダー構造の参照

有効なスペースフォルダーパスのルール

Qlik Cloud Analytics で、ロードスクリプトのファイルを参照するための構文は次のとおりです。

[lib:// (スペース名):(接続名)/(フォルダー名)/(ファイル名)]

完全なフォルダーパスを指定する必要があります。相対パスはサポートされていません。

スペースが存在しない場合は、ステートメントは実行できず、エラーが返されます。

フォルダーパスには、階層構造で複数のフォルダーを含めることができます。パス内の各 folder_name は / 文字で区切る必要があります。

フォルダー構造内に存在するファイルを参照する場合、パスでは次のものは使用できません。

//
\
\\
/./
/../

スペース、フォルダー、またはファイル名の末尾のピリオド記号 (.) は、上記のリストの構成に表示されない限り、許容されます。

非準拠の構文

次の例は、パスの無効な構文とみなされます。

Load [Transactions] from 'lib:\\Demo:DataFiles\Sales2024\France.qvd';

store [Transactions] into 'lib://Demo:DataFiles/Sales2024/./France.qvd';

Load [Transactions] from 'lib://Demo:DataFiles/Sales2024/../France.qvd';

store [Transactions] into 'lib://Demo:DataFiles//Sales2024//France.qvd';

使用されているスクリプトステートメントのタイプによっては、非準拠の構文によってリロードが失敗したり、異なる動作で実行されたりする可能性があります。詳細については、次を参照してください。

ファイルからのデータのロード

Qlik Cloud Analytics では、ロードスクリプト内でデータファイルからデータをロードするときに、LOAD ステートメントを使用したり、QVS コードを挿入したりできます。どちらの場合も、階層的なスペースフォルダー構造をスクリプトステートメントで参照できます。有効なスペースフォルダーパスのルールに従ってください。さらに、ファイルと参照されるすべてのフォルダーが、指定された場所に既に存在している必要があります。存在していない場合、リロードは失敗します。

ロードスクリプト内の LOAD ステートメント

スペースのトップレベルパスにあるファイルへの参照

この例では、個人スペースからファイル orders.csv をロードします。ファイルは特定のフォルダー内ではなく、スペース内のトップレベルパスに配置されます。

LOAD * FROM [lib://DataFiles/orders.csv];

この例では、共有スペース、管理スペース、またはデータスペースからファイル orders.csv をロードします。スペースの名前は TeamSharedSpace です。ファイルは特定のフォルダー内ではなく、スペース内のトップレベルパスに配置されます。

LOAD * FROM [lib://TeamSharedSpace:DataFiles/orders.csv];

スペース内の特定のフォルダーパスへの参照

この例では、個人スペース内のフォルダー Orders By Region からファイル orders_Europe.csv をロードします。

LOAD * FROM [lib://DataFiles/Orders By Region/orders_Europe.csv];

この例では、共有スペース、管理スペース、またはデータスペース内のフォルダー Orders By Region からファイル orders_Europe.csv をロードします。スペースの名前は SalesSpace です。

LOAD * FROM [lib://SalesSpace:DataFiles/Orders By Region/orders_Europe.csv];

QVS コードの挿入

スペースのトップレベルパスにある QVS ファイルを参照する

この例では、test.qvs というファイルがロードスクリプトで参照されます。ファイルは TeamSharedSpace というスペースにあります。ファイルは特定のフォルダー内ではなく、スペース内のトップレベルパスに配置されます。

$(Must_Include=lib://TeamSharedSpace:DataFiles/test.qvs)

スペース内の特定のフォルダーパスにある QVS ファイルを参照する

この例では、test.qvs というファイルがロードスクリプトで参照されます。ファイルは TeamSharedSpace というスペース内の SalesData というフォルダーにあります。

$(Must_Include=lib://TeamSharedSpace:DataFiles/SalesData/test.qvs)

データをファイルに保存する

Qlik Cloud のロードスクリプトで Store ステートメントを使用すると、作成されたファイルを保存するスペース内の正確なフォルダーを参照できます。有効なスペースフォルダーパスのルールに従ってください。さらに、Store ステートメントに固有の次の動作も適用されます。

スペースは存在するが、指定されたフォルダーパスが存在しない場合は、スペース内にパスが作成されます。定義されたフォルダー構造に応じて、1 つ以上のフォルダーが作成される場合があります。ファイルが生成され、そこに保存されます。
スペースは存在するが、指定されたフォルダーパスに無効なフォルダー区切り文字 (例: \、\\、//、/./、/../) が使用されている場合でも、Store ステートメントは実行されます。代わりに、出力ファイルはターゲットスペースのトップレベルパスに保存され、指定された名前だけでなく、完全なパスを含む名前が付けられます。
スペースが存在しない場合は、Store ステートメントは実行できず、エラーが返されます。

次の例は、Store ステートメント内のスペースで特定のフォルダーパスを参照する方法を示しています。

スペースのトップレベルパスにファイルを保存する

この例では、テーブル mytable 全体が myfile.qvd という名前のファイルとして Qlik Cloud Analytics にエクスポートされます。ファイルが共有スペース TeamSharedSpace に追加されます。ファイルは特定のフォルダー内ではなく、スペース内のトップレベルパスに配置されます。

Store * from mytable into [lib://TeamSharedSpace:DataFiles/myfile.qvd];

スペース内の特定のフォルダーパスにファイルを保存する

この例では、テーブル mytable 全体が myfile.qvd という名前のファイルとして Qlik Cloud Analytics にエクスポートされます。ファイルは TeamSharedSpace というスペース内の SalesData というフォルダーに追加されます。

Store * from mytable into [lib://TeamSharedSpace:DataFiles/SalesData/myfile.qvd];