このページでは、Looker のネイティブ配信先と Looker インスタンスで利用可能な統合サービスに、Look と Explore を提供する方法について説明します。ダッシュボードのスケジュール設定については、ダッシュボードのスケジュール設定と送信のドキュメント ページをご覧ください。
Looker スケジューラは、コンテンツ配信の設定を構成するポップアップ ウィンドウの名前です。Look については、Scheduler を使用して 1 回限りの配信や定期的な配信を送信できます。Explore は 1 回限りの配信としてのみ送信できます。Explore のコンテンツを定期的に配信するようにスケジュール設定するには、まず Look として保存する必要があります。
Looker デベロッパーである場合は、これらの開発オプションを有効にするために、[Development Mode] をオフにする必要があります。
使用可能なデリバリー オプションは、Looker 管理者によって付与されるデリバリー関連の権限によって異なります。
フォルダからスケジューラを開く
Explore の場合、スケジューラはフォルダからではなく、[Explore] 内からのみ開くことができます。
フォルダまたはサブフォルダからスケジューラを開くには、配信するダッシュボードを含むフォルダまたはサブフォルダを検索します。フォルダに移動すると、フォルダ内の Look とダッシュボードがリストビューまたはグリッドビューに一覧表示されます。
管理者が [拡張ナビゲーション] Labs 機能を有効にしている場合、拡張された新しい左側のナビゲーション パネルの [[フォルダ] セクションでフォルダのリストを展開することによって、フォルダにアクセスできます。
カレンダーアイコンは、そのコンテンツについて1回以上の定期配信をスケジュールしたことを示します(グリッドビューでカレンダーアイコンを表示させる(存在する場合)には、コンテンツサムネイルにマウスオーバーする必要があります)。
リストビューで、次の方法で Scheduler を開くことができます。
- アイテムのカレンダーアイコンが表示されていればクリックします
- 項目のその他メニューをクリックし、[スケジュールの編集](項目のスケジュールがすでにある場合)、[スケジュールを追加](項目のスケジュールがまだ設定されていない場合)の順に選択する)、[送信](1 回限りの配信の作成)を選択します
- コンテンツを開いて、右上の歯車メニューをクリックし、[スケジュール](定期的な配信の場合)または [送信](1 回限りの配信の場合)を選択します。
グリッド表示では、次の方法でスケジューラを開くことができます。
- アイテムのカレンダーアイコンが表示されていればクリックします
- コンテンツを開いて、右上の歯車メニューをクリックし、[スケジュール](定期的な配信の場合)または [送信](1 回限りの配信の場合)を選択します。
配信の作成
Looker コンテンツ内から配信を作成するには、コンテンツの右上にある歯車アイコンをクリックし、[スケジュール](定期的な配信の場合)または [送信](1 回限りの配信の場合)を選択します。
Lookerに以下のような、スケジュールに関する選択項目を示したポップアップでレガシースケジューラが表示され、PDF形式でメールに送信されるレガシーダッシュボードの定期配信が表示されます。
Look配信のレガシースケジューラの表示は次のようになります。
繰り返し行う配信の場合、レガシースケジューラの左側のパネルに、そのコンテンツに対して作成されたすべてのスケジュールが表示され、現在作成中または編集中のスケジュールのタイトルがハイライトされます。 左側のパネルには、直近で更新された時点から新しい順にスケジュールがリストされます。 既存のスケジュールを複製または削除するには、スケジュールの右側にある [複製] または [削除] アイコンをそれぞれクリックします。
このコンテンツについて作成する最初のスケジュールの場合は、デフォルト値に設定されたスケジューリング オプションがメインパネルに表示されます。これらの値は必要に応じて変更できます。 このコンテンツについて、これまでにスケジュールを作成したことがある場合は、そのスケジュールについて保存したスケジュール設定がメインパネルのリストの上部に表示されます。 次に、以下のリソースをご覧ください。
- 既存のスケジュールのオプションを編集するには、そのスケジュールを選択して必要に応じてオプションを変更します。完了したら、[保存] をクリックします。
- 同じコンテンツの追加のスケジュールを作成するには、[新規 +] をクリックして追加のスケジュールの設定を入力します。
完了したら、[保存] をクリックします。
以下のセクションでは、各スケジューリング設定について説明します。
配信の名前付け
[スケジュールに名前を付ける] フィールドで、スケジュールに一意のタイトルを付けます。タイトルは、スケジュールを保存した後、作成したスケジュールのリスト、および [管理者] パネルのスケジュール管理ページに表示されます。
配信の宛先によっては、タイトルが他の場所に表示されることもあります。
- メール配信の場合、タイトルはメールの件名に使用され、メールの添付ファイルを使用する形式を選択した場合は、ファイル名の一部として使用されます。
- Webhook の場合、タイトルは Webhook ペイロードの [タイトル] 項目に含まれます。
- Amazon S3バケットへの配信の場合、タイトルは配信のファイル名、および送信されるエラーメールがあればそこにも使用されます。 配信のファイル名は
TITLE_TIMESTAMP_HASH
の形式に従います。ここで、HASH
は 6 文字のランダムな ID です。TIMESTAMP
はYYYY-MM-DDTHHMM
のパターンに従います(たとえば、2019 年 5 月 31 日午前 9 時 33 分の場合、タイムスタンプの部分は、2019-05-31T0933
のようになります)。 - 添付ファイルを生成する統合サービスへの配信の場合、タイトルは、配信のファイル名に含まれます。
SFTP配信の場合、タイトルは、配信のファイル名に含まれます。 配信のファイル名は
TITLE_TIMESTAMP_TOKEN
の形式に従います。ここで、TOKEN
は 6 文字のランダムな ID です。TIMESTAMP
はYYYY-MM-DDTHHMM
のパターンに従います(たとえば、2019 年 5 月 31 日午前 9 時 33 分の場合、タイムスタンプの部分は、2019-05-31T0933
のようになります)。SFTP 配信では、英数字、アンダースコア(_)、ハイフン(-)文字のみを使用できます。Looker は、[スケジュールに名前を付ける] フィールドへの入力から、
A-Z
、a-z
、0-9
、_
、-
以外の文字を除外します。
配信先の選択
Looker 管理者が権限をどのように構成したかによって、すべての配信先が表示されないことがあります。
[このデータの配信先] 設定では、データ配信の宛先オプションがいくつか表示される場合があります。各宛先では、異なる配信オプションが提供されます。
宛先には以下が含まれます。
- メールアドレス
- webhook
- Amazon S3 バケット
- SFTP
- Looker 管理者がインスタンスで有効にしている統合サービス - Look と Explore の提供に使用できるサービスのリストについては、サードパーティ統合の配信オプションをご覧ください。
データの宛先を選択すると、新しい設定フィールドが表示され、メールアドレスやWebhook URLなど、その宛先に関する特定の詳しい情報を追加できます。
メールの配信オプション
[このデータの配信先] セクションで [メール] を選択します。コンテンツは、指定したメールアドレスのリストに配信されます。
[Who should it be emailed to?] セクションで、受信者のメールアドレスを入力します。1 つまたは複数のメールアドレスをカンマで区切って入力し、[追加] をクリックします。
Lookerインスタンスの設定や権限割り当てによっては、Lookerインスタンスのどのユーザーアカウントにも関連付けられていないメールアドレスにメールを送信できる場合があります。 これらは外部メールとして仕分けられます。 外部ユーザーにコンテンツを配信するには、Looker 管理者からコンテンツを外部ユーザーに配信する権限を付与されているか、それらの受信者のメールドメインをスケジュール設定されたコンテンツのメールドメインの許可リストに追加しておく必要があります。
受信者が他のLookerユーザーである場合、そのユーザーにはメールからダッシュボードにリンクバックするオプションが表示されます。ただし、Looker管理者がLookerインスタンスのメール送信されるデータのポリシーを [データのみ送信] に設定している場合、または [リンクを含める] オプションの選択を解除している場合を除きます。
すべての受信者がスケジュールされたメール配信を登録解除すると、ユーザーと管理者のスケジュール管理ページであっても、そのスケジュールが Looker から削除されます。ある受信者がメールグループの代理として購読を解除した場合、そのグループの全メンバーがスケジュールされているメール配信を受信しなくなります。
メール配信の詳細については、このページの詳細な配信オプションの適用をご覧ください。
[カスタム メッセージを含めます] をオンにして、メールの本文にカスタム メッセージを追加します。Looker では、カスタム メッセージの文字数の上限が 1,500 文字に設定されています。
メール配信は、20 MB(メール本文で配信される形式)と 15 MB(添付ファイルとして配信される形式の場合)を超えることはできません。
Webhook の配信オプション
ウェブフックは、インターネットベースサービス間のやり取りをトリガーする、一般化しつつある方法です。 Zapier などのウェブサービスを使用すると、Webhook を使用して Looker データを幅広いアプリケーションに配信できます。たとえば、Webhook への Look またはダッシュボードの定期的な配信をスケジュール設定できます。配信を設定するときに、Looker では Webhook アドレスの入力を求められます。
[このデータの配信先] セクションで [Webhook] を選択します。[Webhook URL] セクションに、この配信で Looker が HTTPS リクエストを送信する URL を入力します。ウェブフックの処理に使用しているウェブサービスからこのURLを入手することができます。 Webhook を設定するには、ご利用のウェブサービスを開き、次の設定を行います。
- LookerがHTTPSリクエストを送信するURLを入手します。
- Lookerデータ配信の宛先アプリケーションを指定します。 宛先アプリケーションは、Lookerからデータを受信するため、追加の設定を要求する場合があります。
正確な手順は、ダッシュボードの配信に使用しているウェブサービスと宛先アプリケーションによって異なります。Looker から Webhook データを受信するために他のアプリケーションを設定するためのガイドラインについては、Webhook を使用して Look とダッシュボードをスケジューリングする(3.46 以降)に関する Looker コミュニティ投稿をご覧ください。
Lookerはウェブフックへの配信を最大30分間試みます。 宛先がウェブフックの配信の試行に対して30分以内に応答できることを確認してください。
Amazon S3 バケットの配信オプション
Amazon S3バケットは、大量のデータを保存するためによく使われています。 Lookerで使用できるようにするには、まずご自身または会社がAmazonでS3バケットを作成しておく必要があります。
Amazon S3の宛先オプションを選択する場合、Lookerはこのページで説明されているように、書式設定およびAmazon S3バケットに関する追加設定を入力するよう求めます。 Amazon S3 バケットを使用してデータを提供する方法については、S3 へのスケジューリング(無制限)に関する Looker コミュニティの投稿をご覧ください。
[データの配信先] セクションで [Amazon S3] を選択します。[S3 の詳細] セクションが表示され、Amazon S3 バケットに関する情報の入力を求められます。
- バケット: Amazon S3 バケットの名前。
- オプションのパス: データを保存するフォルダ(存在する場合)。
- アクセスキー: Amazon が提供する S3 バケットへのアクセスキー ID。
- 秘密鍵: Amazon が提供している S3 バケットへのシークレット アクセスキー。
- リージョン: S3バケットがホストされている Amazon のサービス地域。
SFTP サーバーの配信オプション
[データの配信先] セクションで [SFTP] を選択して、ダッシュボードを SFTP サーバーに配信します。データまたはビジュアリゼーションが大きすぎてメールで送信できない場合には、SFTPサーバーに結果を送信するとよいでしょう。 この配信オプションを選択する場合、Lookerは以下で説明されているように、SFTPサーバーアドレス、ユーザー名、パスワードを入力するよう求めます。
SFTP配信について、次の点に注意してください。
- Looker からの SFTP 配信を受信するには、ネットワーク管理者が Looker の IP アドレスを SFTP サーバーの IP 許可リストまたは受信トラフィック ルールに追加していることを確認してください。
- SFTP サーバーに配信する場合、配信のファイル名に使用できるのは英数字、アンダースコア(_)、ハイフン(-)文字のみです。Looker は、[スケジュールに名前を付ける] フィールドへの入力から、
A-Z
、a-z
、0-9
、_
、-
以外の文字を除外します。
SFTP を選択した場合、Looker はサーバーの URL とログイン情報を求めるプロンプトを表示します。
アドレス: データを送信するSFTPサーバーのURLまたはIPアドレス。例:
sftp://files.looker.com/Marketing/In/
またはsftp://192.168.0.10/Marketing/In/
この URL の例は
/
文字で終わります。これは、ファイルがIn
という名前のフォルダに保存されることを示します。末尾の/
を省略すると、ファイルはMarketing
フォルダに保存され、ファイル名に「In
」が追加されます。ファイルを作成したいフォルダへの書き込みアクセス権限が必要です。ユーザー名とパスワード: SFTP サーバーの認証情報
優先鍵交換アルゴリズム: このフィールドは省略可能です。このフィールドを設定するには、接続を確立するための優先SSH鍵交換アルゴリズムを選択します。 次のオプションを使用できます。
diffie-hellman-group-exchange-sha1
diffie-hellman-group1-sha1
diffie-hellman-group14-sha1
diffie-hellman-group-exchange-sha256
接続が5分以内に確立されない場合は、別のアルゴリズムを選択します。 アルゴリズムによっては、SSH鍵の生成に長い時間がかかる場合があります。 このオプションでは、より時間のかからないアルゴリズムを使用することができます。 アルゴリズムのいずれかを選択すると、それがSSH接続を確立するための優先アルゴリズムになります。 アルゴリズムがサーバーでサポートされていない場合は、以降の試みで他のすべてのアルゴリズムが使用されます。 このフィールドを [デフォルト] に設定すると、接続ライブラリの元のアルゴリズムの順序が使用されます。
現在、SFTPサポートは、ユーザー名とパスワードの資格情報に制限されています。 SSH秘密鍵資格情報はサポートされていません。
Looker の SFTP 配信でサポートされるホストキー アルゴリズムは次のとおりです。
ssh-rsa
ssh-dss
ssh-rsa-cert-v01@openssh.com
ssh-rsa-cert-v00@openssh.com
Looker では、SFTP サーバーの SFTP フィンガープリントが保存されます。SFTP配信でエラーが発生する場合、それはSFTPフィンガープリントが無効であることを示している可能性があります。 その場合、Looker管理者に連絡してください。
SFTP サーバへのデータ配信時にエラー
Java::JavaLang::NullPointerExceptions
が発生する場合、JRuby のバグにより、Looker から SFTP 先へのSSH接続に楕円曲線(EC)アルゴリズムやホスト鍵が使用できないことが原因である可能性があります。SFTP 宛先へのデータ送信の問題を回避するために、~/.ssh/config
ファイルまたは/etc/ssh_config
ファイルで EC アルゴリズムを使用しないでください。また、Looker ホストの~/.ssh
に EC ホストキーを保存しないでください。
Lookerは、次のファイル名に関する規則を使用して、ファイルをSFTPサーバー上の指定されたディレクトリにアップロードします。
<name>_<timestamp>_<token>.<file extension>
- Looker が
A-Z
、a-z
、0-9
、_
または-
を除くすべての文字を削除した後、[スケジュールに名前を付ける] フィールドに入力した名前 - スケジュールが送信されたタイムスタンプ(
%Y-%m-%dT%H%M
形式) - ランダムな6文字の文字列で構成されるトークン
- ファイル拡張子
例: Test_Schedule_2019-04-11T1130_HWkvys.csv
サードパーティ統合の配信オプション
スケジューラには、Looker管理者が有効にしたアクションが表示されます。 サービスに応じて、宛先固有の追加のフィールドがある場合があります。 これらのフィールドは、選択したアクションをデータで実行するために必要な追加情報を統合サービスに提供します。 統合からのデータ配信について詳しくは、アクション ハブを介したデータの共有ドキュメント ページのダッシュボードやクエリデータの配信セクションをご覧ください。
各サービスに必要な情報の説明を確認するには、下のリストのいずれかでサービスの宛先を見つけ、[この宛先の使用方法] の列に示されている URL に移動します。
以下のリストは、Look、またはExploreの結果を提供できるすべての統合サービスを示しています。
データ形式の選択
メールによる配信の場合、Looker 管理者が Looker インスタンスのメール配信データポリシーをリンクのみ送信に設定している場合、データ形式を選択するオプションは利用できません。
Look と Explore は、配信先に応じて異なる形式オプションを提供します。配信の形式を選択するには、スケジューラの [データの形式] セクションで該当するアイコンを選択します。
各形式の各宛先への配信方法については、下の表をご覧ください。
フォーマット | メール | Webhook | Amazon S3 | SFTP |
---|---|---|---|---|
Data Table | データテーブルは、HTMLのメール本文で配信されます。 | この宛先では使用できません | この宛先では使用できません | この宛先では使用できません |
可視化 | ビジュアリゼーションは、メール本文で1つの画像として配信されます。 | この宛先では使用できません | この宛先では使用できません | この宛先では使用できません |
CSV | データテーブルは、カンマ区切りのテキストファイル添付として配信されます。 | データテーブルは、カンマ区切りのテキストファイル添付として配信されます。 | データテーブルは、カンマ区切りのテキストファイル添付として配信されます。 | データテーブルは、カンマ区切りのテキストファイル添付として配信されます。 |
XLSX | データテーブルは、Excelファイル添付として配信されます。 | データテーブルは、Excelファイル添付として配信されます。 | データテーブルは、Excelファイル添付として配信されます。 | データテーブルは、Excelファイル添付として配信されます。 |
JSON — Simple | データテーブルは、JSONファイル添付として配信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 | データテーブルは、JSONファイル添付として配信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 | データテーブルは、JSONファイル添付として配信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 | データテーブルは、JSONファイル添付として配信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 |
JSON - Label | この宛先では使用できません | データテーブルは、JSON形式で配信されます。この形式では、Looker は JSON 出力でレンダリングされた値としてフィールド ラベルを使用します。 | この宛先では使用できません | この宛先では使用できません |
JSON - Simple、Inline | この宛先では使用できません | データテーブルは、JSON形式で直接送信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 | この宛先では使用できません | この宛先では使用できません |
JSON - Detailed、Inline | この宛先では使用できません | データテーブルは、フィールドメタデータ、キャッシュ情報、クエリが完了した時刻、クエリの実行に要した時間などの追加の詳細とともに、JSON形式で直接送信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 | データテーブルは、フィールドメタデータ、キャッシュ情報、クエリが完了した時刻、クエリの実行に要した時間などの追加の詳細とともに、JSON形式で直接送信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 | データテーブルは、フィールドメタデータ、キャッシュ情報、クエリが完了した時刻、クエリの実行に要した時間などの追加の詳細とともに、JSON形式で直接送信されます。この形式では、Looker は、フィールドのラベルではなく、ディメンションまたはメジャーのフィールド名をレンダリング値として使用します。 |
テキスト | データテーブルは、タブ区切りのテキストファイル添付として配信されます。 | データテーブルは、タブ区切りのテキストファイル添付として配信されます。 | データテーブルは、タブ区切りのテキストファイル添付として配信されます。 | データテーブルは、タブ区切りのテキストファイル添付として配信されます。 |
HTML | データテーブルは、HTMLファイル添付として配信されます。 | データテーブルは、HTMLファイル添付として配信されます。 | データテーブルは、HTMLファイル添付として配信されます。 | データテーブルは、HTMLファイル添付として配信されます。 |
配信のトリガー
Explore または Look の 1 回限りの配信を行う場合、このオプションは表示されません。
定期配信をスケジュールする場合、配信をトリガーする2つのオプションがあります。
- 繰り返し間隔: このページの [配信の繰り返しの指定] セクションで設定した配信スケジュールを使用するには、このオプションを選択します。
- データグループの更新: LookML のデベロッパーがデータグループを構成している場合、データグループのトリガー、キャッシュの管理、関連性PDT の再構築を行った後に配信するようスケジュールできます。
データグループ トリガーの指定
Explore または Look の 1 回限りの配信を行う場合、あるいは定期的な配信の繰り返し間隔トリガーを指定した場合、このオプションは表示されません。
データグループ トリガーを使用するには、スケジューラの [トリガー] セクションで [データグループの更新] を選択します。次に、[データグループの選択] プルダウンからソースデータグループを選択します。
データグループ トリガーを使用してコンテンツをスケジュールするには、コンテンツの基になるモデルファイルにデータグループが含まれている必要があります。データグループがクエリや PDT のキャッシュの処理に使用されていない場合でも、Looker には、特定の Look やダッシュボードタイルに含まれるモデルで定義されているすべてのデータグループが一覧表示されます。
データグループに基づくスケジュールは、そのデータグループのすべての永続的なPDTの再生成プロセスが完了したときにのみ配信がトリガーされるため、配信には最新のデータが含まれます。
配信の繰り返しの指定
Explore または Look の 1 回限りの配信を行う場合、または定期的な配信に対してデータグループの更新トリガーを指定した場合は、このオプションは表示されません。
繰り返し間隔を使用する配信の場合、[このスケジュールを配信する] セクションでスケジュールのタイミングをカスタマイズできます。スケジューラの [トリガー] セクションで [繰り返し間隔] を選択します。タイミングのオプションは、[毎日]、[毎週]、[毎月]、[毎時]、または [分単位] を選択したかどうかによって異なります。[詳細オプション] セクションでスケジュールのタイムゾーンを調整できます。
[毎時] と [分単位] の間隔の終了時刻は範囲に含まれません。最後の配信は、指定の終了時刻より前の、選択された配信間隔が経過した最後の時刻に送信されます。 たとえば、コンテンツが午前 12 時から午後 11 時の間で [毎時] にスケジュール設定されている場合、コンテンツは毎時、午前 12 時から午後 10 時に送信されます。コンテンツが、午前 12 時から午後 11 時の間で 30 分ごとに [分単位] でスケジュール設定されている場合、そのタイムフレームでの最終配信は午後 10 時 30 分に送信されます。
フィルタを配信に適用する
Explore を送信する場合、このオプションは表示されません。
フィルタを含む Look またはダッシュボードを配信する場合は、フィルタ条件を変更して、配信された結果をさらにフィルタリングできます。
[フィルタ] をクリックすると、この Look またはダッシュボードの配信のフィルタを表示、変更できます。スケジューラでこれらのフィルタ オプションを変更しても、Look またはダッシュボードのフィルタは変更されません。ダッシュボード フィルタにフィルタ値が必要で、スケジュール フィルタが空白の場合、配信時にスケジュールは表示されません。
Look またはダッシュボードでフィルタとして使用されるフィールド名を変更する場合は、スケジュール設定された Look およびダッシュボードの[フィルタ] セクションを確認し、必要に応じて変更内容を反映するよう更新してください。スケジュールされたコンテンツ配信に機能しなくなったFilter(参照されているフィールドが変更されているなど)が含まれている場合、フィルタされていないデータが定期配信で公開される可能性があります。
配信をさらにカスタマイズするには、[ユーザー属性に一致] フィルタ オプションを使用します(Looker 管理者がユーザー属性と呼ばれるユーザー固有の値を設定した場合)。これらの属性のいずれかにフィルタを設定すると、各ユーザーの結果が自動的にカスタマイズされます。つまり、ワンタイム配信の送信の場合でも、カスタマイズされた結果を多数のユーザーに送信することができます。 詳細については、ユーザー属性のドキュメント ページをご覧ください。
詳細な配信オプションの適用
[詳細オプション] セクションで、配信をさらにカスタマイズできます。[詳細オプション] の横にある矢印をクリックして、このメニューを展開します。利用可能なオプションは、選択した配信の宛先と形式、および、ダッシュボード、Look、Explore を配信するかどうかによって異なります。下の表のリンクは、Looker のネイティブの宛先への Look または Explore の配信に使用できる各オプションの説明を対象としています。サードパーティ統合への配送では、独自の詳細オプションが利用できる場合があります。
次の場合にこのスケジュールを送信:
Look の定期的な配信では、特定の条件が満たされた場合にのみ Look コンテンツを配信するようにスケジュールをカスタマイズできます。アラートは、ダッシュボード タイルと同様の機能を提供します。
[次の場合にこのスケジュールを送信] プルダウンで、検索結果がない場合、または結果がない場合、または結果がない場合のみ Look コンテンツを配信するかどうかを指定します。たとえば、ユーザー フィルタを使用して、特定の在庫数を下回ったアイテム、特定の値を超えた支出など、モニタリングする状況の条件を作成し、その条件に該当する場合にのみコンテンツを配信できます。
また、[前回の実行以降に変更された結果] の横にあるチェックボックスをオンにすると、前回のデータ送信後にクエリ結果が変更された場合にのみ配信するように指定できます。すべての結果の上限オプションを使用する場合、このオプションは使用できません。
上限
データに対して以下の制限オプションのいずれかを選択して、配信のサイズを制限することができます。
- 表の結果: データは単一の配信として送信されます。
- すべての結果: データがストリーミングされます(詳しくは、Looker の行制限とはをご覧ください。ベスト プラクティス ページをご覧ください)。ファイルサイズ、ブラウザ、メモリの制限が無視されるため、このオプションは大規模なデータセットに役立ちます。
[表の結果] を選択した場合、Lookerは保存済みの Look または Explore に設定された行制限に従います。[All Results] を選択した場合、Lookerは保存済みの Look の設定、および Looker の一般的な 5,000 行の制限に関係なく、クエリのすべての行を返します。これは非常に大きなデータセットを取得するのに適している場合がありますが、クエリがデータベースに対して大きくなりすぎないように注意する必要があります。
メールの制限オプション
LookおよびExploreを送信する場合、メールサーバーのメッセージサイズ制限内に収まるようにメールのサイズを制限することができます。データに対して以下の制限オプションのいずれかを選択します。
- 表の結果: データは 5,000 行の上限で送信されます。これは、[データテーブル] または [可視化] の形式オプションを使用する唯一の選択肢です。5,000行を超えるメールは送信されません。
- すべての結果: テキスト、CSV、JSON(シンプル、サイドカー、HTML)のファイル形式オプションを使用している場合は、すべて保存された Look の結果の行 を送信できます。このオプションでは、保存済みのLookに設定された制限またはLookerの一般的な5,000行の制限は無視されます。ただし、メールアプリケーションが添付ファイルを受け入れることができるように、合計 15 MB のデータ制限があります。15 MBを超える添付ファイル付きのメールは送信されません。データテーブルまたは可視化の形式を指定してから [すべての結果] を選択すると、Looker は自動的にテキスト添付を使用する形式に変更し、すべての結果の送信をサポートします。
スケジュール設定したメールの行またはデータの制限範囲内であることを確認するには、受信者として自分のメールアドレスを入力し、[テスト送信] をクリックしてデータを自分に送信します。メールが届かない場合は、メールの行制限またはデータ制限に達している可能性があります。
メール オプション
メール配信には、以下に説明する追加の配信オプションがあります。
Run schedule as recipient
このオプションは、宛先がメールの場合にのみ使用できます。
[受信者としてスケジュールを実行する] オプションを使用すると、管理者は、ユーザーのリストを指定して、各ユーザーの権限に応じて、そのユーザー自身がクエリを実行した場合と同様のコンテンツ配信を受信できるようにすることができます。管理者以外のユーザーも、各自のメールアドレスを入力し、自分の権限に応じてコンテンツをクエリしたかのように配信を受信することができます。 つまり、各ユーザーのアクセス フィルタとユーザー属性は、各メールに含まれるデータに適用されます。
例えば、Looker管理者が次のレポートを一連のユーザーにスケジュールする必要があり、各ユーザーのアクセスフィルタの値が異なるとします。
ユーザー A のアクセスフィルタが users.state = 'California'
として設定されています。[受信者としてスケジュールを実行する] が選択されている場合は、スケジュール設定されたクエリはアクセス フィルタ users.state = 'California'
を適用し、フィルタが適用された次の結果をユーザーAに送信します。
このオプションでは、スケジュールを作成するユーザーの権限と、[Who should it be emailed to?] テキスト フィールドに追加されるメールアドレスの種類が考慮されます。
[受信者としてスケジュールを実行する] オプションを利用できない場合があります。
- 管理者ではないユーザーが自分以外のメールアドレスを追加する
- Looker管理者が無効なユーザーのメールを追加する
- Looker管理者が、そのLookerユーザーに属していないメールを追加する(Lookerアカウントは、受信者の横のLookerアイコンで表示されます)
- [受信者としてスケジュールを実行する] オプションが選択される前にメールが追加されている場合、このオプションは自動的に無効になります。該当するメールアドレスが受信者リストから削除されると、オプションは再度有効になります。
- [受信者としてスケジュールを実行する] オプションを選択した後にメールが追加された場合、そのメールアドレスを追加するとエラーが発生し、[誰にメールを送信しますか?] フィールドからメールが自動的に削除されます。[受信者としてケジュールを実行する] オプションは引き続き有効です。
[受信者としてスケジュールを実行する] が有効なスケジュールでユーザーが受信者としてリストされている特殊なケースでは、そのユーザーのアカウントが無効にされ、無効にされたユーザーへのそのスケジュールによる次回の配信が失敗します。そのユーザーのアカウントが削除されている場合、そのスケジュール全体でどの受信者にも配信できなくなります。Looker 管理者または see_schedules
権限を持つユーザーは、[Admin] パネルの [Scheduler History] ページで、この障害を診断できます。
Include links
Looker の管理者が Looker インスタンスのメールデータポリシーを [リンクとデータを送信] に設定している場合、スケジューラーには [リンクを含める] オプションが表示されます。このオプションをオンにすると、メールデータ配信に Looker へのリンクが表示されます。配信された Looks と Explore に対して「レポート全体を表示」、配信されたダッシュボードに対して「ダッシュボード全体を表示」というリンクになります。
このリンクにより、メールの受信者はLookerインスタンスのデータをさらに探索することができます。 受信者がLookerで配信コンテンツを表示するには、Lookerにログインし、またそのコンテンツのベースとなっているモデルにアクセスする権限を持っていなければなりません。 データ配信メールからこのリンクを削除する場合は、[リンクを含める] チェックボックスのチェックを外します。
書式設定オプション
可視化形式を使用しない配信では、以下で説明する追加の配信オプションを使用できます。
ビジュアリゼーションオプションを適用する
このオプションは、可視化形式の Look または Explore 配信では使用できません。
データ配信に [Apply visualization options] を選択すると、テーブルグラフと同じように表示されます。ビジュアリゼーション用に構成された [Plot]、[Series]、[Formatting] メニューには、次の設定が適用されます。
- 行番号を表示
- 合計を非表示にする
- 行の合計を非表示にする
- 表示する行を制限する。最大 500 行まで表示または非表示にします
- Show Full Field Name
- 各列のカスタムラベル(JSON - 詳細、インラインJSON - 詳細、インライン形式は常にフィールド ラベルではなく生のフィールド名を使用します - Looker が JSON フォーマットでフィールドをレンダリングする方法については、JSON フォーマットの変更に関するコミュニティの投稿を参照してください)。
- Excel 形式で表示されたテーブルグラフをダウンロードするための条件付きフォーマット
Excel の Look と Explore の条件付き書式が、テーブルのグラフを可視化したもので、スケール A ルールが適用されている場合にのみ表示されます。
Look の [Data] セクションまたはダッシュボード タイルの [Explore from here] ウィンドウに表示されるデータを送信するように Looker の [ビジュアリゼーション オプションを適用する] の選択を解除します。[JSON - Label] は、[Apply visualization options] がオフの場合でも、フィールド ラベルを使用します。
書式設定されたデータ値
このオプションは、可視化形式の Look または Explore 配信では使用できません。
データの書式を設定できます。
- Looker の Explore のエクスペリエンスに近い形式(ただし、リンクなどの一部の機能は一部のファイル形式ではサポートされていない)を表示するには、[書式設定されたデータ値] を選択します。
- Looker デベロッパーが配置した特殊文字(長い数字の丸めや特殊文字の追加など)を適用しない場合は、[書式設定されたデータ値] を選択解除します。これは多くの場合、処理のためにデータを他のツールに送信するときに推奨されます。
表の解像度
ビジュアリゼーション形式でコンテンツをメールに配信する場合、[表の解像度] プルダウン メニューを使用してビジュアリゼーションの幅をカスタマイズできます。幅は以下のように設定できます。
- 通常: 800 ピクセル
- ワイド: 1,680 ピクセル
[ワイド] を選択して、ビジュアリゼーションの幅がメール クライアントで設定されている上限を超える場合、メール配信の受信者は、ビジュアリゼーション全体を表示するために水平方向にスクロールする必要がある場合があります。
タイムゾーン
デフォルトでは、アカウントに関連付けられたタイムゾーンを利用して、データ配信を送信するタイミングが決定されます。アカウントに関連付けられているタイムゾーンがない場合、Looker は [アプリケーションのタイムゾーン] の設定を使用します。別のタイムゾーンを指定する場合は、[カスタム タイムゾーンを使用する] を選択します。選択したタイムゾーンは、Lookやダッシュボードのデータに影響しません。配信のタイミングのみに影響します。
配信のテスト
[送信テスト] ボタンをクリックして、指定した宛先に 1 回限りのテスト配信を送信します。
配信の保存
配信設定の要約は、スケジューラの下部に表示されます。
1 回限りの配信では、配信オプションの構成が完了したら、[送信] ボタンをクリックして、指定した宛先にコンテンツをすぐに配信します。
定期的な配信の場合、配信オプションの構成が完了したら、[すべて保存] ボタンをクリックしてスケジュールを保存し、ウィンドウを閉じます。コンテンツは配信設定に従って配信されます。 スケジューラを再度開くと、保存したスケジュールが左のパネルに表示されます。 [複製] アイコンや [削除] アイコンをクリックして、スケジュールを複製または削除できます。
保存したスケジュールは、ユーザー プロファイルの [作成したスケジュール] ページと、[管理者] パネルの [スケジュール] ページと [スケジュールの履歴] ページに表示されます。詳しくは、このページの配信の表示 セクションをご覧ください。
配信の表示
作成したスケジュールを表示できます。また、適切な権限があれば、Looker インスタンスのすべてのスケジュールも表示できます。
作成した配信の表示
[作成したスケジュール] ページで作成したすべてのスケジュールのリストを表示できます。このリストにアクセスするには、ユーザー プロファイル アイコンをクリックして [スケジュール] を選択します。作成したスケジュールの表示と管理について詳しくは、スケジュールされたデータ配信の確認のページをご覧ください。
他のユーザーが作成した配信の表示
Looker 管理者から [スケジュール] および [スケジュール履歴] 管理ページを表示する権限が付与されている場合は、Looker インスタンス全体のスケジュールの一覧を表示できます。ただし、これらのスケジュールを編集または削除することはできません。
知っておくべきこと
ときどき、スケジュールされたメール配信が1人以上の受信者に届かないことがあります。 これは、基になるモデルにエラーがある場合、受信者にデータへのアクセス権がない場合、レンダリングの問題やページエラーがある場合に発生する可能性があります。
他にも発生する可能性がある問題がいくつかあります。
- 会社で Looker の [管理者] セクションで独自のメール設定を設定している場合、Looker 管理者はその設定が正しいこと、メール プロバイダが正常に機能していることを確認する必要があります。
- 上限設定に応じて、データ配信は 5,000 行、または添付ファイル付きのメールの場合は最大ファイルサイズ 15 MB、インライン コンテンツを含むメールの場合は最大ファイルサイズ 20 MB に制限されます。これらの制限を超える行やデータが含まれるメールは送信されません。
- メールが予定した時間に送信されないものの、最終的に到着する場合は、他の Looker タスクと競合している可能性があります。これらのタスクには、他のスケジュールされたメール、多数のユーザーが同時にデータを探索している場合、永続派生テーブルが構築されている場合、などがあります。 このような場合は、競合するタスクについてLooker管理者に確認してください。
- 特定のメールが配信リストから消失し続ける場合は、ユーザーがそのスケジュールされたメールの購読を解除している可能性があります。グループメールエイリアスを使用して複数のユーザーに送信する場合、これは特に問題になる可能性があります。個々の受信者はそのメールエイリアス全体の購読を解除できるためです。 購読解除について理解する必要がある場合は、スケジューラ購読解除イベントのモニタリングに関する Looker コミュニティの投稿をご覧ください。