このページでは、レガシーダッシュボードからのコンテンツの配信について説明します。ダッシュボードのスケジュール設定については、ダッシュボードのスケジュール設定と送信のドキュメント ページをご覧ください。
このページでは、Looker のネイティブ配信先、および Looker インスタンスで利用可能な統合サービスに、レガシーダッシュボードを配信する方法の概要を説明します。Look と Explore に固有の情報については、Look と Explore の配信に関するドキュメント ページをご覧ください。
Looker スケジューラは、コンテンツ配信の設定を構成するポップアップ ウィンドウの名前です。
Looker デベロッパーである場合は、これらの開発オプションを有効にするために、[Development Mode] をオフにする必要があります。
使用可能なデリバリー オプションは、Looker 管理者が付与したデリバリー関連の権限によって異なります。
フォルダからスケジューラを開く
フォルダまたはサブフォルダからスケジューラを開くには、配信するダッシュボードを含むフォルダまたはサブフォルダを検索します。フォルダに移動すると、フォルダ内の Look とダッシュボードがリスト表示またはギャラリー表示で表示されます。
管理者が [拡張ナビゲーション] Labs 機能を有効にしている場合、拡張された新しい左側のナビゲーション パネルの [[フォルダ] セクションでフォルダのリストを展開することによって、フォルダにアクセスできます。
カレンダーアイコンは、そのコンテンツについて1回以上の定期配信をスケジュールしたことを示します(グリッドビューでカレンダーアイコンを表示させる(存在する場合)には、コンテンツサムネイルにマウスオーバーする必要があります)。
リスト表示またはグリッド表示では、次の方法でスケジューラを開くことができます。
- アイテムのカレンダー アイコンがある場合は [新規] をクリックし、
- 項目のその他メニューをクリックし、[配信をスケジュール] を選択します。
Lookerに以下のような、スケジュールに関する選択項目を示したポップアップでスケジューラが表示されます。 配信の設定の詳細については、ダッシュボードのスケジュール設定と送信に関するドキュメント ページをご覧ください。
デリバリーの作成
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 管理者がインスタンスで有効にしている統合サービス - ダッシュボードの配信に使用できるサービスのリストは、このページのサードパーティ統合の配信オプションで確認できます。
データの宛先を選択すると、新しい設定フィールドが表示され、メールアドレスや Webhook URL など、その宛先に関する特定の詳しい情報を追加できます。
メールの配信オプション
[このデータの配信先] セクションで [メール] を選択します。コンテンツは、指定したメールアドレスのリストに配信されます。
[Who should it be emailed to?] セクションで、受信者のメールアドレスを入力します。1 つまたは複数のメールアドレスをカンマで区切って入力し、[追加] をクリックします。
Lookerインスタンスの設定や権限割り当てによっては、Lookerインスタンスのどのユーザーアカウントにも関連付けられていないメールアドレスにメールを送信できる場合があります。 これらは外部メールとして仕分けられます。 外部ユーザーにコンテンツを配信するには、Looker 管理者からコンテンツを外部ユーザーに配信する権限を付与されているか、それらの受信者のメールドメインをスケジュール設定されたコンテンツのメールドメインの許可リストに追加しておく必要があります。
受信者が他のLookerユーザーである場合、そのユーザーにはメールからダッシュボードにリンクバックするオプションが表示されます。ただし、Looker管理者がLookerインスタンスのメール送信されるデータのポリシーを [データのみ送信] に設定している場合、または [リンクを含める] オプションの選択を解除している場合を除きます。
スケジュール設定されたメール配信へのすべての受信者の登録を解除すると、ユーザーと管理者のスケジュール管理ページでも、そのスケジュールが Looker から削除されます。ある受信者がメールグループの代理として購読を解除した場合、そのグループの全メンバーがスケジュールされているメール配信を受信しなくなります。
メール配信の詳細については、このページの詳細な配信オプションの適用をご覧ください。
[カスタム メッセージを含めます] をオンにして、メールの本文にカスタム メッセージを追加します。Looker では、カスタム メッセージの文字数の上限が 1,500 文字に設定されています。
メール配信は、20 MB(メール本文で配信される形式)と 15 MB(添付ファイルとして配信される形式の場合)を超えることはできません。
Webhook の配信オプション
ウェブフックは、インターネットベースサービス間のやり取りをトリガーする、一般化しつつある方法です。 Webhook で Zapier などのウェブサービスを使用すると、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 バケットを使用してデータを提供する方法について詳しくは、Looker コミュニティの投稿のスケジュール(無制限)の S3 への投稿をご覧ください。
[データの配信先] セクションで [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 に移動します。
以下のリストは、ダッシュボードを提供できるすべての統合サービスを示しています。
データ形式の選択
メールへの配信の場合、Looker 管理者が Looker インスタンスのメール配信データポリシーを [リンクのみ送信] に設定している場合、データ形式を選択するオプションは利用できません。
配信の形式を選択するには、スケジューラの [データの形式] セクションで該当するアイコンを選択します。各形式の各宛先への配信方法については、下の表をご覧ください。
フォーマット | メール | Webhook | Amazon S3 | SFTP |
---|---|---|---|---|
ダッシュボードは、PDF形式で配信されます。 メールへの配信では、PDF は添付ファイルとして配信されます。デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 | ダッシュボードは、PDF形式で配信されます。 デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 | ダッシュボードは、PDF形式で配信されます。 デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 | ダッシュボードは、PDF形式で配信されます。 デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 | |
可視化 | ビジュアリゼーションは、メール本文で PNG 画像として配信されます。デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 | ダッシュボードのビジュアリゼーションは、1 つの PNG ファイルとして配信されます。デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 | ダッシュボードのビジュアリゼーションは、1 つの PNG ファイルとして配信されます。デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 | ダッシュボードのビジュアリゼーションは、1 つの PNG ファイルとして配信されます。デフォルトレイアウトでは、タイルはダッシュボードに配置されているとおりに表示されますが、[詳細オプション] では他のレイアウトやサイズを設定できます。 |
CSV ZIPファイル | ダッシュボードからの書式設定されないデータは、zipされたディレクトリ内のカンマ区切り値(CSV)ファイルのコレクションとして配信されます。 メール配信の場合は、ZIP ファイルはメールの添付ファイルとして配信されます。 | ダッシュボードからの書式設定されないデータは、zipされたディレクトリ内のカンマ区切り値(CSV)ファイルのコレクションとして配信されます。 | ダッシュボードからの書式設定されないデータは、zipされたディレクトリ内のカンマ区切り値(CSV)ファイルのコレクションとして配信されます。 | ダッシュボードからの書式設定されないデータは、zipされたディレクトリ内のカンマ区切り値(CSV)ファイルのコレクションとして配信されます。 |
ダッシュボードのクエリ制限は、データ配信形式によって異なります。
- CSV ZIPファイルには、基になるクエリで指定されている行数(最大5,000行まで)が含まれます。
- PDFおよびビジュアリゼーション形式では、実行時の各タイルの静的な画像が表示されます。 テーブルのビジュアリゼーションを示すタイルの場合は、ファイルがレンダリングされたときにタイル内に多くの行が表示されたことがわかります。タイルをスクロールすることはできません。
配信のトリガー
1 回限りの配信の場合、このオプションは表示されません。
定期配信をスケジュールする場合、配信をトリガーする2つのオプションがあります。
- 繰り返し間隔: このページの [配信の繰り返しの指定] セクションで設定した配信スケジュールを使用するには、このオプションを選択します。
- データグループの更新: LookML のデベロッパーがデータグループを構成している場合、データグループのトリガー、キャッシュの管理、関連性PDT の再構築を行った後に配信するようスケジュールできます。
データグループ トリガーの指定
1 回限りの配信を送信する場合や、定期的な配信に繰り返しトリガーを指定した場合は、このオプションは表示されません。
データグループのトリガーを使用するには、スケジューラの [トリガー] で [データグループの更新] を選択します。次に、[データグループを選択] プルダウンでソースデータグループを選択します。
データグループ トリガーを使用してコンテンツをスケジュールするには、コンテンツの基になるモデルファイルにデータグループが含まれている必要があります。データグループがクエリや PDT のキャッシュの処理に使用されていない場合でも、Looker には、特定の Look やダッシュボードタイルに含まれるモデルで定義されているすべてのデータグループが一覧表示されます。
データグループに基づくスケジュールは、そのデータグループのすべての永続的なPDTの再生成プロセスが完了したときにのみ配信がトリガーされるため、配信には最新のデータが含まれます。
複数のデータグループに関連付けられたタイルが複数あるダッシュボードの場合、ダッシュボードに関連付けられている任意のデータグループから選択できます。選択したデータグループが完了すると、ダッシュボード全体が送信されます。
配信の繰り返しの指定
1 回限りの配信を送信する場合、または定期的な配信にデータグループ更新トリガーを指定した場合は、このオプションは表示されません。
繰り返し間隔を使用する配信の場合、[このスケジュールを配信する] セクションでスケジュールのタイミングをカスタマイズできます。スケジューラの [トリガー] セクションで [繰り返し間隔] を選択します。タイミングのオプションは、[毎日]、[毎週]、[毎月]、[毎時]、または [分単位] を選択したかどうかによって異なります。[詳細オプション] セクションでスケジュールのタイムゾーンを調整できます。
[毎時] と [分単位] の間隔の終了時刻は範囲に含まれません。最後の配信は、指定の終了時刻より前の、選択された配信間隔が経過した最後の時刻に送信されます。 たとえば、コンテンツが午前 12 時から午後 11 時の間で [毎時] にスケジュール設定されている場合、コンテンツは毎時、午前 12 時から午後 10 時に送信されます。コンテンツが、午前 12 時から午後 11 時の間で 30 分ごとに [分単位] でスケジュール設定されている場合、そのタイムフレームでの最終配信は午後 10 時 30 分に送信されます。
配信へのフィルタの適用
フィルタを含む Look またはダッシュボードを提供している場合は、フィルタ条件を変更して、配信結果をさらにフィルタできます。
[Filters] をクリックすると、配信のこの Look またはダッシュボードに関連付けられているフィルタを確認、変更できます。Scheduler でこれらのフィルタ オプションを変更しても、Look またはダッシュボードでフィルタが変更されることはありません。ダッシュボード フィルタのフィルタ値が必須で、スケジュール フィルタが空白の場合、配信時にスケジュールに結果は表示されません。
Look またはダッシュボードでフィルタとして使用されるフィールド名を変更する場合は、スケジュール設定された Look およびダッシュボードの[フィルタ] セクションを確認し、必要に応じて変更内容を反映するよう更新してください。スケジュールされたコンテンツ配信に機能しなくなったFilter(参照されているフィールドが変更されているなど)が含まれている場合、フィルタされていないデータが定期配信で公開される可能性があります。
配信をさらにカスタマイズするには、[ユーザー属性に一致] フィルタ オプションを使用します(Looker 管理者がユーザー属性と呼ばれるユーザー固有の値を設定した場合)。これらの属性のいずれかにフィルタを設定すると、各ユーザーの結果が自動的にカスタマイズされます。つまり、ワンタイム配信の送信の場合でも、カスタマイズされた結果を多数のユーザーに送信することができます。 詳細については、ユーザー属性のドキュメント ページをご覧ください。
詳細な配信オプションの適用
[Advanced options] セクションでは、配信内容を細かくカスタマイズできます。[詳細オプション] の横にある矢印をクリックしてこのメニューを開きます。利用可能なオプションは、選択した配信の宛先と形式、および、ダッシュボード、Look、Explore を配信するかどうかによって異なります。以下の表のリンクは、Looker のネイティブな宛先へのダッシュボード配信に使用できる各オプションの説明に移動します。サードパーティ統合への配送では、独自の詳細オプションが利用できる場合があります。
フォーマット | メール | Webhook | Amazon S3 | SFTP | ||||
---|---|---|---|---|---|---|---|---|
メール オプション | Run schedule as recipient | この目的地では利用できません | この目的地では利用できません | この目的地では利用できません | ||||
Include links | ||||||||
書式設定オプション | 単一列レイアウトの仕様 | 書式設定オプション | 単一列レイアウトの仕様 | 書式設定オプション | 単一列レイアウトの仕様 | 書式設定オプション | 単一列レイアウトの仕様 | |
表の展開 | 表の展開 | 表の展開 | 表の展開 | |||||
タイムゾーン | タイムゾーン | タイムゾーン | タイムゾーン | |||||
Paper size | Paper size | Paper size | Paper size | |||||
可視化 | メール オプション | Run schedule as recipient | この目的地では利用できません | この目的地では利用できません | この目的地では利用できません | |||
Include links | ||||||||
書式設定オプション | 単一列レイアウトの仕様 | 書式設定オプション | 単一列レイアウトの仕様 | 書式設定オプション | 単一列レイアウトの仕様 | 書式設定オプション | 単一列レイアウトの仕様 | |
表の解像度 | この目的地では利用できません | この目的地では利用できません | この目的地では利用できません | |||||
タイムゾーン | タイムゾーン | タイムゾーン | タイムゾーン | |||||
CSV(ZIP) | メール オプション | Run schedule as recipient | この目的地では利用できません | この目的地では利用できません | この目的地では利用できません | |||
Include links | ||||||||
書式設定オプション | ビジュアリゼーションオプションを適用する | 書式設定オプション | ビジュアリゼーションオプションを適用する | 書式設定オプション | ビジュアリゼーションオプションを適用する | 書式設定オプション | ビジュアリゼーションオプションを適用する | |
書式設定されたデータ値 | 書式設定されたデータ値 | 書式設定されたデータ値 | 書式設定されたデータ値 | |||||
タイムゾーン | タイムゾーン | タイムゾーン | タイムゾーン |
メール オプション
以下のオプションは、メールでのデータ配信をスケジュール設定している場合にのみ使用できます。
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にログインし、またそのコンテンツのベースとなっているモデルにアクセスする権限を持っていなければなりません。 データ配信メールからこのリンクを削除する場合は、[リンクを含める] チェックボックスのチェックを外します。
書式設定オプション
使用できる形式オプションは、選択したデータ形式と宛先によって異なります。
単一列レイアウトの仕様
すべてのネイティブ ロケーションへの PDF とビジュアリゼーションの配信には、1 列のレイアウトを使用できます。
PDFまたはビジュアリゼーション形式でのダッシュボード配信では、ダッシュボードタイルが垂直の1列に表示される単一列レイアウトでPDFを印刷するオプションがあります。 このオプションを使用するには [単一列のレイアウトを使用する] チェックボックスをオンにするか、チェックボックスをオフのままにして、タイルがダッシュボード内で配置されるようにします
表の解像度
ダッシュボードにこのオプションを表示するには、[単一列レイアウトを使用する] オプションをオンにする必要があります。
ビジュアリゼーション形式でコンテンツをメールに配信する場合、[表の解像度] プルダウン メニューを使用してビジュアリゼーションの幅をカスタマイズできます。幅は以下のように設定できます。
- 標準: 800 ピクセル
- ワイド: 1,680 ピクセル
[ワイド] を選択して、ビジュアリゼーションの幅がメール クライアントで設定されている上限を超える場合、メール配信の受信者は、ビジュアリゼーション全体を表示するために水平方向にスクロールする必要がある場合があります。
表の展開
ダッシュボード タイルのサムネイルに表示される行だけでなく、データテーブルのすべての行を PDF ダッシュボードの配信またはダウンロードで表示するには、[Expand tables] チェックボックスをオンにします。[表を展開する] オプションが表示されない場合は、Looker インスタンスに適切なバージョンの Chromium レンダラをインストールする方法について Looker 管理者にお問い合わせください。
ビジュアリゼーションオプションを適用する
このオプションは、すべての宛先への CSV 配信で使用できます。
データ配信でビジュアリゼーションと同じオプションを使用するかどうかを設定できます。
[ビジュアリゼーションオプションを適用] を選択すると、配信設定の一部が適用されます。これにより、配信は表チャートのように表示されます。ビジュアリゼーション用に構成された [プロット]、[シリーズ]、[書式設定] の各メニューのいずれかの設定が、データ配信に適用されます。
- 行番号を表示
- 合計を非表示にする
- 行の合計を非表示にする
- 表示する行を制限する。最大 500 行まで表示または非表示にします
- Show Full Field Name
- 各列のカスタムラベル
これらのビジュアリゼーション オプションを適用しない場合は、[ビジュアリゼーション オプションを適用] を選択解除します。Looker は、ダッシュボード タイルの [ここから探索] ポップアップの [データ] セクションに表示されているとおりにデータを送信します。
書式設定されたデータ値
このオプションは、すべての宛先への CSV 配信で使用できます。
データの書式を設定できます。
- Looker の Explore のエクスペリエンスに近い形式(ただし、リンクなどの一部の機能は一部のファイル形式ではサポートされていない)を表示するには、[書式設定されたデータ値] を選択します。
- Looker デベロッパーが配置した特殊文字(長い数字の丸めや特殊文字の追加など)を適用しない場合は、[書式設定されたデータ値] を選択解除します。これは多くの場合、処理のためにデータを他のツールに送信するときに推奨されます。
タイムゾーン
このオプションは、すべてのネイティブな送信先への、すべてのデータ形式での配信に使用できます。
デフォルトでは、アカウントに関連付けられたタイムゾーンを利用して、データ配信を送信するタイミングが決定されます。 アカウントに関連付けられているタイムゾーンがない場合、Looker は [アプリケーションのタイムゾーン] の設定を使用します。別のタイムゾーンを指定する場合は、[カスタム タイムゾーンを使用] を選択します。選択したタイムゾーンは、Lookやダッシュボードのデータに影響しません。配信のタイミングのみに影響します。
Paper size
このオプションは、すべてのネイティブ配信先に PDF を配信できます。
[用紙サイズ] プルダウン メニューから選択することで、ダッシュボード PDF の最適なサイズと向きを指定することもできます。場合によっては、大きなビジュアリゼーションや重なっているダッシュボードタイルのグループは、PDFのページにきれいに収まるようにサイズを変更する必要があります。 [用紙サイズ] が表示されない場合は、Looker インスタンスに適した最新バージョンの Chromium レンダラのインストールについて Looker 管理者にお問い合わせください。
配信のテスト
[送信テスト] ボタンをクリックして、指定した宛先に 1 回限りのテスト配信を送信します。
配送を保存しています
配信設定の要約は、スケジューラの下部に表示されます。
1 回限りの配信では、配信オプションの構成が完了したら、[送信] ボタンをクリックして、指定した宛先にコンテンツをすぐに配信します。
定期的な配信の場合は、配信オプションの設定が完了したら、[すべて保存] ボタンをクリックしてスケジュールを保存し、ウィンドウを閉じます。コンテンツは配信設定に従って配信されます。 スケジューラを再度開くと、保存したスケジュールが左のパネルに表示されます。 [複製] アイコンや [削除] アイコンをクリックして、スケジュールを複製または削除できます。
保存したスケジュールは、ユーザー プロファイルの [作成したスケジュール] ページと、[管理者] パネルの [スケジュール] ページと [スケジュールの履歴] ページに表示されます。詳細については、このページの配送の表示セクションをご覧ください。
配送状況の表示
作成したスケジュールを表示できます。また、適切な権限があれば、Looker インスタンスのすべてのスケジュールも表示できます。
作成した配信の表示
[作成したスケジュール] ページで作成したすべてのスケジュールのリストを表示できます。このリストにアクセスするには、ユーザー プロファイル アイコンをクリックして [スケジュール] を選択します。作成したスケジュールの表示と管理について詳しくは、スケジュールされたデータ配信の確認のページをご覧ください。
他のユーザーが作成した配送状況の表示
Looker 管理者から [スケジュール] および [スケジュール履歴] 管理ページを表示する権限が付与されている場合は、Looker インスタンス全体のスケジュールの一覧を表示できます。ただし、これらのスケジュールを編集または削除することはできません。
知っておくべきこと
ときどき、スケジュールされたメール配信が1人以上の受信者に届かないことがあります。 これは、基になるモデルにエラーがある場合、受信者にデータへのアクセス権がない場合、レンダリングの問題やページエラーがある場合に発生する可能性があります。
他にも発生する可能性がある問題がいくつかあります。
- 会社で Looker の [管理者] セクションで独自のメール設定を設定している場合、Looker 管理者はその設定が正しいこと、メール プロバイダが正常に機能していることを確認する必要があります。
- 上限設定に応じて、データ配信は 5,000 行、または添付ファイル付きのメールの場合は最大ファイルサイズ 15 MB、インライン コンテンツを含むメールの場合は最大ファイルサイズ 20 MB に制限されます。これらの制限を超える行やデータが含まれるメールは送信されません。
- メールが予定した時間に送信されないものの、最終的に到着する場合は、他の Looker タスクと競合している可能性があります。これらのタスクには、他のスケジュールされたメール、多数のユーザーが同時にデータを探索している場合、永続派生テーブルが構築されている場合、などがあります。 このような場合は、競合するタスクについてLooker管理者に確認してください。
- 特定のメールが配信リストから消失し続ける場合は、ユーザーがそのスケジュールされたメールの購読を解除している可能性があります。グループメールエイリアスを使用して複数のユーザーに送信する場合、これは特に問題になる可能性があります。個々の受信者はそのメールエイリアス全体の購読を解除できるためです。 購読解除について理解する必要がある場合は、スケジューラ購読解除イベントのモニタリングに関する Looker コミュニティの投稿をご覧ください。