このページでは、Looker の組み込み配信先と Looker インスタンスで利用可能な統合サービスに、Look と Explore を提供する方法について説明します。ダッシュボードのスケジュール設定については、ダッシュボードのスケジュール設定と送信のドキュメント ページをご覧ください。
Looker スケジューラは、コンテンツ配信の設定を構成するポップアップ ウィンドウの名前です。Look では、スケジューラを使用して 1 回限りまたは定期的な配信を送信できます。Explore は 1 回限りの配信としてのみ送信できます。Explore のコンテンツを定期的に配信するようにスケジュール設定するには、まず Look として保存する必要があります。
Looker デベロッパーである場合は、これらの開発オプションを有効にするために、[Development Mode] をオフにする必要があります。
利用可能な配信オプションは、Looker 管理者から付与されている配信関連の権限によって異なります。
フォルダからスケジューラを開く
Explore の場合、フォルダからではなく、[Explore] 内からのみスケジューラを開くことができます。
フォルダまたはサブフォルダからスケジューラを開くには、配信するダッシュボードを含むフォルダまたはサブフォルダを検索します。フォルダに移動すると、フォルダ内の Look とダッシュボードがリストビューまたはグリッドビューに一覧表示されます。
カレンダーアイコンは、そのコンテンツについて1回以上の定期配信をスケジュールしたことを示します(グリッドビューでカレンダーアイコンを表示させる(存在する場合)には、コンテンツサムネイルにカーソルを合わせる必要があります)。
リストビューで、次の方法でスケジューラーを開くことができます。
- アイテムのカレンダーアイコンが表示されていればクリックします
- 項目のその他メニューをクリックし、[スケジュールの編集](項目のスケジュールがすでにある場合)、[スケジュールを追加](項目のスケジュールがまだ設定されていない場合)の順に選択する)、[送信](1 回限りの配信の作成)を選択します
- コンテンツを開いて、右上の歯車メニューをクリックし、[スケジュール](定期的な配信の場合)または [送信](1 回限りの配信の場合)を選択します。
グリッドビューで、次の方法でスケジューラーを開くことができます。
- アイテムのカレンダーアイコンが表示されていればクリックします
- コンテンツを開いて、右上の歯車メニューをクリックし、[スケジュール](定期的な配信の場合)または [送信](1 回限りの配信の場合)を選択します。
配信の作成
Looker コンテンツ内から配信を作成するには、コンテンツの右上にある歯車アイコンをクリックし、[スケジュール](定期的な配信の場合)または [送信](1 回限りの配信の場合)を選択します。
繰り返し行う配信の場合、レガシースケジューラの左側のパネルに、そのコンテンツに対して作成されたすべてのスケジュールが表示され、現在作成中または編集中のスケジュールのタイトルがハイライトされます。左側のパネルには、直近で更新された時点から新しい順にスケジュールがリストされます。既存のスケジュールを複製または削除するには、スケジュールの右側にある [複製] または [削除] アイコンをそれぞれクリックします。
このコンテンツについて作成する最初のスケジュールの場合は、デフォルト値に設定されたスケジューリング オプションがメインパネルに表示されます。これらの値は必要に応じて変更できます。このコンテンツについて、これまでにスケジュールを作成したことがある場合は、そのスケジュールについて保存したスケジュール設定がメインパネルのリストの上部に表示されます。次に、以下の手順を行います。
- 既存のスケジュールのオプションを編集するには、そのスケジュールを選択して必要に応じてオプションを変更します。完了したら、[保存] をクリックします。
- 同じコンテンツの追加のスケジュールを作成するには、[新規] をクリックして追加のスケジュールの設定を入力します。
完了したら、[保存] をクリックします。
以下のセクションでは、各スケジューリング設定について説明します。
配信の名前付け
[スケジュールに名前を付ける] フィールドで、スケジュールに一意のタイトルを付けます。タイトルは、スケジュールを保存した後、作成したスケジュールのリスト、および [管理者] パネルのスケジュール管理ページに表示されます。
配信の宛先によっては、タイトルが他の場所に表示されることもあります。
- メール配信の場合、タイトルはメールの件名に使用され、メールの添付ファイルを使用する形式を選択した場合は、ファイル名の一部として使用されます。
- 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 データをさまざまなアプリケーションに配信することができます。たとえば、Look またはダッシュボードの Webhook への定期配信のスケジュールを設定することができます。配信を設定するときに、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
サードパーティ統合の配信オプション
Slack、Dropbox、Google ドライブなど、Looker と統合されているサービスへの Look、または Explore の結果をスケジューリングしたり送信したりできます。統合は Looker 管理者が有効にする必要があります。Looker 管理者は、ユーザーと埋め込みユーザーが、サードパーティ統合にデータ送信とスケジュール設定を行うための特定の権限を付与する必要があります。
スケジューラの [宛先] フィールドで統合サービスを選択すると、いくつかの新しいフィールドが表示され、詳細情報の入力を求められます。
次のリストは、Look または Explore の結果を配信できる Looker Action Hub サービスです。
このリストを使用する方法は次のとおりです。
- [README ファイルへのリンク] 列に表示される URL は、Looker と連携する統合サービスを有効にして構成する手順を示しています。
- [この統合の使用方法] 列に表示されている URL は、Looker から統合サービスにデータを送信する方法を示しています。一部の記事には有効化の手順も記載されています。
- [必須 LookML タグ] には、コンテンツの基盤となるモデルの
tags
パラメータで使用する必要があるすべての必須タグが一覧表示されます。 - [アクション タイプ] は、統合サービスが送信するデータのレベル(フィールド、クエリ、ダッシュボード)を示します。フィールド レベルのアクションでは、データテーブル内の指定された 1 つのセルの値が送信されます。クエリレベルのアクションでは、Explore または Look のすべての行など、クエリ全体の結果が送信されます。ダッシュボード レベルのアクションでは、ダッシュボードの画像が送信されます。
- [Google OAuth 認証を使用する] は、統合サービスが認証に Google OAuth 認証情報を使用するかどうかを示します。
- [データ ストリーミングを使用する] は、統合サービスがストリーミング クエリ結果をサポートするかどうかを示します。
統合サービス | 説明 | README ファイルへのリンク | この統合の使用方法 | 必須 LookML タグ | 操作の種類 | Google OAuth 認証を使用する(はい/いいえ) | データ ストリーミングを使用する(はい/いいえ) |
---|---|---|---|---|---|---|---|
Airtable | Airtable のテーブルにレコードを追加する。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | いいえ |
Amazon SageMaker Infer | Amazon SageMaker を使用して推論を実行します。 | README を利用できない | 記事なし | なし | クエリ | いいえ | はい |
Amazon SageMaker Train: 線形学習者 | 線形学習者アルゴリズムを使用して、Amazon SageMaker でトレーニング ジョブを開始します。 | README を利用できない | 記事なし | なし | クエリ | いいえ | はい |
Amazon SageMaker Train: Xgboost | Xgboost アルゴリズムを使用して、Amazon SageMaker でトレーニング ジョブを開始します。 | README を利用できない | 記事なし | なし | クエリ | いいえ | はい |
Amazon Web Services EC2 インスタンスの停止 | Amazon EC2 API を使用して EC2 インスタンスを停止します。 | GitHub の README を読む | コミュニティの記事を表示する | aws_resource_id | フィールド、クエリ | いいえ | いいえ |
Auger | クエリ結果を使用して予測モデルを構築します。 | GitHub の README を読む | README を参照 | なし | クエリ | いいえ | はい |
Azure ストレージ | Azure ストレージでデータファイルを送信して保存します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | はい |
Braze | Braze のアクションにより、Look から REST API エンドポイントを使用して Braze 内のユーザーにフラグを設定できます。結果に braze_id フィールドがタグ付けされていることを確認します。最大エクスポート数: 10000。 |
GitHub の README を読む | README を参照 | braze_id | クエリ | いいえ | はい |
DataRobot | データを DataRobot に送信し、新しいプロジェクトを作成します。 | GitHub の README を読む | README を参照 | なし | クエリ | いいえ | はい |
DigitalOcean — Droplet を停止する | DigitalOcean API を使用して DigitalOcean プロセスを停止します。 | GitHub の README を読む | コミュニティの記事を表示する | digitalocean_droplet_id | フィールド、クエリ | いいえ | いいえ |
DigitalOcean スペース | DigitalOcean ストレージにデータファイルを送信して保存します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | はい |
Dropbox | Dropbox でデータファイルを送信して保存します。 | README を利用できない | ドキュメントを見る | なし | クエリ | はい | いいえ |
Facebook Custom Audiences | 顧客リストから Facebook Ads Custom Audiences にデータをアップロードします。 | GitHub の README を読む | README を参照 | なし | クエリ | はい | はい |
Firebase | Firebase を使用してモバイルにプッシュ通知を送信します。 | README を利用できない | 記事なし | なし | クエリ | いいえ | いいえ |
Google広告カスタマーマッチ | Google 広告のカスタマー マッチにデータをアップロードします。 | GitHub の README を読む | ドキュメントを見る | なし | クエリ | はい | はい |
Googleアナリティクスデータインポート | Google アナリティクスのデータセットにデータをアップロードします。 | GitHub の README を読む | README を参照 | なし | クエリ | はい | はい |
Google Cloud Storage | Google Cloud Storage バケットにデータファイルを書き込みます。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | はい |
Google ドライブ | Google ドライブにデータを送信します。 | README を利用できない | ドキュメントを見る | なし | クエリ | はい | はい |
Google スプレッドシート | Google スプレッドシートに CSV データを送信します。 | README を利用できない | ドキュメントを見る | なし | クエリ | はい | はい |
Hubspot の会社 | Hubspot V3 API を使用して、会社にプロパティを追加します。 | GitHub の README を読む | README を参照 | hubspot_company_id | クエリ | いいえ | はい |
Hubspot の連絡先 | Hubspot V3 API を使用して、連絡先にプロパティを追加します。 | GitHub の README を読む | README を参照 | hubspot_contact_id | クエリ | いいえ | はい |
Kloudio | Google スプレッドシートにデータを追加します。 | GitHub の README を読む | README を参照 | なし | クエリ | いいえ | いいえ |
mParticle | ユーザーまたはイベントデータを Looker から mParticle に一括エクスポートします。 | GitHub の README を読む | README を参照 | README を参照 | クエリ | いいえ | はい |
Salesforce キャンペーン | Salesforce キャンペーンに連絡先やリードを追加します。 | GitHub の README を読む | README を参照 | sfdc_contact_id または sfdc_lead_id | クエリ | はい | いいえ |
セグメント グループ | セグメント グループに特性やユーザーを追加します。 | GitHub の README を読む | ドキュメントを見る | segment_group_id および user_id、または segment_group_id および segment_anonymous_id | クエリ | いいえ | はい |
セグメント ID | ID を使用してセグメント ユーザーに特性を追加します。 | GitHub の README を読む | ドキュメントを見る | メールアドレスまたは user_id または segment_anonymous_id または segment_group_id | クエリ | いいえ | はい |
セグメント トラック | セグメントが提供するいくつかの統合に接続して、マーケティング ワークフローのユーザーを識別してターゲットにします。 | GitHub の README を読む | ドキュメントを見る | メールアドレスまたは user_id または segment_anonymous_id または segment_group_id | クエリ | いいえ | はい |
SendGrid | データを送信し、SendGrid の API を使用してメールアドレスに送信する結果をスケジュールします。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | いいえ |
Slack | OAuth を使用して、Looker コンテンツを Slack のダイレクト メッセージ、パブリック チャンネル、プライベート チャンネルで送信できます。これが利用できるのは、6.24 以降の Looker ホスト型のデプロイで、IP 許可リスト機能が無効である場合です。 | README を利用できない | ドキュメントを見る | なし | クエリ | はい | はい |
Slack アタッチメント(API トークン) | ユーザーの認証情報とともにデータを Slack チャンネルに直接送信します。Slack の追加機能については、Lookerbot ドキュメントを参照することもできます。 | GitHub の README を読む | ドキュメントを見る | なし | クエリ | いいえ | いいえ |
Teams - 受信 Webhook | 受信 Webhook を使用して Microsoft Teams にデータを送信します。 | GitHub の README を読む | README を参照 | なし | クエリ | いいえ | いいえ |
Tray | Tray.io が提供するさまざまな統合に接続して、ワークフローを自動化します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | はい |
Twilio — データを送信する | Twilio の API を使用して Look からデータを送信するか、結果のスケジュールを設定して電話番号に送信します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | いいえ |
Twilio — メッセージを送信する | Look で、一連の電話番号(電話番号としてタグ付けされたデータ列)にメッセージを送信します。 | GitHub の README を読む | README を参照 | 電話 | フィールド、クエリ | いいえ | いいえ |
Zapier | Zapier が提供するさまざまな統合に接続して、ワークフローを自動化します。 | GitHub の README を読む | コミュニティの記事を表示する | なし | クエリ | いいえ | はい |
データ形式の選択
メールによる配信の場合、Looker 管理者が Looker インスタンスのメール配信データポリシーをリンクのみ送信に設定している場合、データ形式を選択するオプションは利用できません。
Look と Explore は、配信先に応じて異なる形式オプションを提供します。配信の形式を選択するには、スケジューラの [データの形式] セクションで該当するアイコンを選択します。
各形式の各宛先への配信方法については、下の表をご覧ください。
形式 | メール | Webhook | Amazon S3 | SFTP |
---|---|---|---|---|
Data Table | データテーブルは、HTMLのメール本文で配信されます。 | この宛先ではご利用になれません | この宛先ではご利用になれません | この宛先ではご利用になれません |
Visualization | ビジュアリゼーションは、メール本文で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 コンテンツを配信するかどうかを指定します。たとえば、ユーザー フィルタを使用して、特定の在庫数を下回ったアイテム、特定の値を超えた支出など、モニタリングする状況の条件を作成し、その条件に該当する場合にのみコンテンツを配信できます。
また、[and results changed since last run] の横にあるチェックボックスをオンにして、最後のデータ配信が送信されてからクエリ結果が変更された場合にのみ配信を行うように指定することもできます。[すべての結果] の制限オプションを使用する場合、このオプションは使用できません。
上限
データに対して以下の制限オプションのいずれかを選択して、配信のサイズを制限することができます。
- 表の結果: データは単一の配信として送信されます。
- すべての結果: データがストリーミングされます(詳しくは、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 は自動的にテキスト添付を使用する形式に変更し、すべての結果の送信をサポートします。
送信日時を設定したメールの行またはデータ制限内に収まっていることを確認するには、受信者として自分のメールアドレスを入力し、[テストの送信] をクリックしてデータをすぐに自分自身に送信することができます。メールが届かない場合は、メールの行制限またはデータ制限に達している可能性があります。
メール オプション
メールへの配信には、[受信者としてスケジュールを実行する] と [リンクを含める] の追加の配信オプションがあります。
受信者としてスケジュールを実行する
このオプションは、宛先がメールの場合にのみ使用できます。
[受信者としてスケジュールを実行する] オプションを使用すると、管理者は、ユーザーのリストを指定して、各ユーザーの権限に応じて、そのユーザー自身がクエリを実行した場合と同様のコンテンツ配信を受信できるようにすることができます。管理者以外のユーザーも、各自のメールアドレスを入力し、自分の権限に応じてコンテンツをクエリしたかのように配信を受信することができます。つまり、各ユーザーのアクセス フィルタとユーザー属性は、各メールに含まれるデータに適用されます。
たとえば、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] ページで、この障害を診断できます。
リンクを含める
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 コミュニティの投稿をご覧ください。