Aracılığıyla paylaş

ALTER STREAMING TABLE

Şunlar için geçerlidir:onay işareti evet olarak işaretlenmiş Databricks SQL

Aşağıdakilerden birini yapmanızı sağlar:

  • Mevcut akış tablosunu yenilemek için bir zamanlama ekleyin.
  • Akış tablosu için mevcut yenileme zamanlamasını değiştirme.
  • Akış tablosu için yenileme zamanlamasını kaldırın. Zamanlama bırakılırsa, nesnenin en son verileri yansıtacak şekilde el ile yenilenmesi gerekir.

Tabloya veya sütunlarına açıklama eklemek veya değiştirmek için COMMENT ONkullanın.

Sözdizimi

ALTER STREAMING TABLE table_name
  {
    { ADD | ALTER } SCHEDULE [ REFRESH ] schedule_clause |
    DROP SCHEDULE |
    ALTER COLUMN clause |
    SET ROW FILTER clause |
    DROP ROW FILTER |
    SET TAGS clause |
    UNSET TAGS clause |
  }

  schedule_clause
  { EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } |
    CRON cron_string [ AT TIME ZONE timezone_id ] }

Parametre

  • table_name

    Tanımını değiştirmek istediğiniz akış tablosunun adı. Ad bir zamansal belirtim içermemelidir.

  • SCHEDULE [ REFRESH ] schedule_clause

    Akış tablosuna zamanlama eklemenize veya zamanlamasını değiştirmenize olanak tanır.

    • EVERY number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS }

      Düzenli aralıklarla gerçekleşen bir yenileme zamanlamak için EVERY söz dizimini kullanın. EVERY söz dizimi belirtilirse, akış tablosu veya gerçekleştirilmiş görünüm, sağlanan değere göre belirli aralıklarla yenilenir; örneğin, HOUR, HOURS, DAY, DAYS, WEEKveya WEEKS. Aşağıdaki tabloda, numberiçin kabul edilen tamsayı değerleri listelenmiştir.

      Zaman birimi Tamsayı değeri
      HOUR or HOURS 1 <= H <= 72
      DAY or DAYS 1 <= D <= 31
      WEEK or WEEKS 1 <= W <= 8

      Not

      Dahil edilen zaman biriminin tekil ve çoğul biçimleri sematik olarak eşdeğerdir.

    • CRON cron_string [ AT TIME ZONE timezone_id ]

      Yenileme zamanlamak için quartz cron değeri kullanın. Geçerli time_zone_values kabul edilir. AT TIME ZONE LOCAL desteklenmez.

      Yoksa AT TIME ZONE , oturum saat dilimi kullanılır. AT TIME ZONE yoksa ve oturum saat dilimi ayarlanmadıysa bir hata oluşur. SCHEDULE , ile eşanlamlı olarak eşdeğerdir SCHEDULE REFRESH.

  • DEĞİŞTİR COLUMN

    Önemli

    Bu özellik Genel Önizleme aşamasındadır.

    Bir sütunun özelliğini değiştirir.

  • SET ROW FILTER madde

    Önemli

    Bu özellik Genel Önizleme aşamasındadır.

    Akış tablosuna bir satır filtresi işlevi ekler. Akış tablosuna yapılan sonraki tüm sorgular, işlevin boole TRUEolarak değerlendirdiği satırların bir alt kümesini alır. Bu, işlevin belirli satırları filtreleyip filtrelemeyeceğini belirlemek için çağıran kullanıcının kimlik veya grup üyeliklerini incelediği ayrıntılı erişim denetimi amaçları için yararlı olabilir.

  • DROP ROW FILTER

    Önemli

    Bu özellik Genel Önizleme aşamasındadır.

    Mevcutsa akış tablosundan satır filtresini kaldırır. Gelecekteki sorgular, otomatik filtreleme olmadan tablodaki tüm satırları döndürür.

  • SET TAGS ( { tag_name = tag_value } [, ...] )

    Önemli

    Bu özellik Genel Önizleme aşamasındadır.

    Akış tablosuna etiket uygulama. Akış tablosuna APPLY TAG etiket ekleme izniniz olmalıdır.

    • tag_name

      Bir sabit STRING. Akış tablosu veya sütunu içinde tag_name benzersiz olmalıdır.

    • tag_value

      Bir sabit STRING.

  • UNSET TAGS ( tag_name [, ...] )

    Önemli

    Bu özellik Genel Önizleme aşamasındadır.

    Akış tablosundan etiketleri kaldırın. Akış tablosundaki etiketleri kaldırma izniniz olmalıdır APPLY TAG .

    • tag_name

      Bir sabit STRING. Akış tablosu veya sütunu içinde tag_name benzersiz olmalıdır.

Örnekler

-- Adds a schedule to refresh the streaming table once a day
-- at midnight in Los Angeles
> ALTER STREAMING TABLE my_st
  ADD SCHEDULE CRON '0 0 0 * * ? *' AT TIME ZONE 'America/Los_Angeles';

-- Alters the schedule to run every 15 minutes for a streaming table
> ALTER STREAMING TABLE my_st
  ALTER SCHEDULE EVERY 15 MINUTES;

-- Drops the schedule for a streaming table
> ALTER STREAMING TABLE my_st
  DROP SCHEDULE;