Tüm Ürünler
Search
Belge Merkezi

Lindorm:Lindorm-cli kullanarak zaman serisi motoruna bağlanma ve kullanma

Son Güncelleme:Oct 12, 2026

Lindorm-cli, Lindorm veritabanlarına bağlanmak ve bunları yönetmek için Lindorm tarafından sağlanan hafif bir komut satırı arabirimidir. Lindorm-cli ile tablo oluşturma, veri sorgulama ve veri yazma gibi temel SQL işlemlerini yapabilirsiniz. Bu konuda, Lindorm zaman serisi motoruna nasıl bağlanılacağı ve nasıl kullanılacağı açıklanmaktadır.

Ön koşullar

İstemci IP adresinizi Lindorm izin listesine ekleyin. Daha fazla bilgi için bkz. İzin listesi ayarlama.

Adım 1: Lindorm-cli'yi yükleme

  1. İşletim sisteminiz için Lindorm-cli kurulum paketini indirin. İndirme bağlantıları aşağıdaki tabloda listelenmiştir.

    Not

    Tablodaki SHA256 sağlama toplamları, indirilen Lindorm-cli paketlerinin bütünlüğünü ve özgünlüğünü doğrular.

    İşletim sistemi

    İndirme bağlantısı

    SHA256 sağlama toplamı

    Linux

    linux için lindorm-cli

    Doğrudan indirme komutu:

    wget https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/lindorm-cli-linux-latest.tar.gz

    fdd0cdece2a3d29124dd9538edefdd66532b950653f049d6b4fd6a21cb2cd6fc

    Linux-arm64

    linux-arm64 için lindorm-cli

    Doğrudan indirme komutu:

    wget https://hbaseuepublic.oss-cn-beijing.aliyuncs.com/lindorm-cli-linux-arm64-latest.tar.gz

    bd602405a2e988cf77d6b3afa2aac35ce72b437038119f4b3a9d926d3ffb5be1

    Mac (Intel çip)

    mac için lindorm-cli

    cfff2a661fe6d48e0d55dbfca149847a3b8c0ef391d59e4694a425a22a44f5be

    Mac (Arm çip)

    mac için lindorm-cli

    1aae53cf83ad40a7386ea5711684d733e9728566c3f7463d00070a56201b79dc

    Windows

    windows-x64 için lindorm-cli

    cf2330fac41cc3d731282cd8dddfd5656ad05c1f8e1113607cf427d0614b23b6

  2. Kurulum paketini çıkarın.

    Linux için paketi çıkarmak üzere aşağıdaki komutu çalıştırın:

    tar zxvf lindorm-cli-linux-latest.tar.gz

    Çıkarma işleminden sonra, lindorm-cli-linux-latest klasörü lindorm-cli dosyasını içerir.

Adım 2: Lindorm zaman serisi motoruna bağlanma

Linux veya Mac'te dağıtılan istemci

  1. lindorm-cli dosyasını içeren dizine gidin.

    cd <lindorm-cli directory>
  2. Zaman serisi motoruna bağlanmak için aşağıdaki komutu çalıştırın:

    ./lindorm-cli -url <Lindorm time series SQL endpoint> -username <username> -password <password> -database <target database name>

    Bağlantı örneği

    ./lindorm-cli -url jdbc:lindorm:tsdb:url=http://ld-4xo90g5i370cu****-proxy-tsdb.lindorm.rds.aliyuncs.com:8242 -username user -password test -database default

    Parametre açıklaması

    Parametre

    Gerekli

    Açıklama

    Lindorm zaman serisi SQL uç noktası

    Evet

    Lindorm zaman serisi motorunun zaman serisi SQL uç noktası. Örnek: jdbc:lindorm:tsdb:url=http://ld-bp12pc23yfb3*-proxy-tsdb-pub.lindorm.rds.aliyuncs.com:8242.

    Not

    Lindorm-cli bağlantı yöntemi ayrıca zaman serisi HTTP uç noktasını da destekler.

    Kullanıcı adı

    Hayır

    Lindorm zaman serisi motoruna bağlanmak için kullanılan kullanıcı adı.

    Zaman serisi motoru için kullanıcı kimlik doğrulaması ve izin doğrulaması devre dışı bırakıldıysa, kullanıcı adı veya parola belirtmeniz gerekmez. Daha fazla bilgi için bkz. Kullanıcı ve izin yönetimi.

    Parola

    Hayır

    Lindorm zaman serisi motoruna bağlanmak için kullanılan parola. Parolanızı unuttuysanız, Lindorm geniş tablo motorunun küme yönetim sisteminde parolanızı sıfırlayın. Daha fazla bilgi için bkz. Kullanıcı parolalarını değiştirme.

    Hedef veritabanı adı

    Hayır

    Lindorm-cli kullanılarak bağlanılacak veritabanı. Varsayılan veritabanı default'tur. Oturum sırasında başka bir veritabanına geçmek için use <hedef veritabanı adı> komutunu çalıştırın.

    Bağlantı başarılı olduğunda aşağıdaki çıktı döner:

    lindorm-cli version: 1.0.xx

    Burada 1.0.xx Lindorm-cli sürüm numarasıdır.

Windows'ta dağıtılan istemci

Yöntem 1

  1. Komut İstemi'ni (CMD) açın ve lindorm-cli.exe dosyasını içeren dizine gidin.

    cd <lindorm-cli.exe directory>
  2. CMD'de zaman serisi motoruna bağlanmak için aşağıdaki komutu çalıştırın:

    lindorm-cli -url <Lindorm time series SQL endpoint> -username <username> -password <password> -database <target database name>

    Bağlantı başarılı olduğunda aşağıdaki çıktı döner:

    Connected to jdbc:lindorm:tsdb:url=http://****-proxy-tsdb-pub.lindorm.rds.aliyuncs.com:8242
    lindorm-cli version: 1.0.xx

    Burada 1.0.xx Lindorm-cli sürüm numarasıdır.

Yöntem 2

Programı açmak için Lindorm-cli.exe öğesine çift tıklayın ve aşağıdaki komutu çalıştırın:

connect <Lindorm time series SQL endpoint> <username> <password> -database <target database name>

Bağlantı başarılı olduğunda herhangi bir çıktı dönmez.

Adım 3: Lindorm zaman serisi motorunu kullanma

Tablo oluşturma

  1. Bir zaman serisi tablosu oluşturun.

    CREATE TABLE sensor (
        device_id VARCHAR NOT NULL,
        region VARCHAR NOT NULL,
        time TIMESTAMP NOT NULL,
        temperature DOUBLE,
        humidity BIGINT,
        PRIMARY KEY(device_id, region, time)
    );
    Not
    • Zaman serisi tablosu oluştururken birincil anahtar (PRIMARY KEY) belirtin. Basic Edition PRIMARY KEY'i desteklemez. Genellikle veri kaynağınızdaki benzersiz bir tanımlayıcıyı PRIMARY KEY olarak kullanın. Örnekler arasında Nesnelerin İnterneti senaryolarında cihaz kimliği, Araçların İnterneti senaryolarında araç kimliği, izleme senaryolarında uygulama kimliği veya ip:port yer alır.

    • Zaman damgası sütun adı time olmalıdır; bu, milisaniye (ms) cinsinden veri zaman damgasını temsil eder.

  2. sensor tablosunun başarıyla oluşturulduğunu doğrulayın.

    SHOW TABLES;

    Sorgu sonucu aşağıdaki gibidir:

    +-------------------+
    | Tables_In_default |
    +-------------------+
    | sensor            |
    +-------------------+
  3. Zaman serisi tablosunun sütunlarını görüntüleyin.

    DESCRIBE TABLE sensor;

    Sorgu sonucu aşağıdaki gibidir:

    +-------------+-----------+------------+------------+--------------+
    | columnName  | typeName  | columnKind | primaryKey | partitionTag |
    +-------------+-----------+------------+------------+--------------+
    | device_id   | VARCHAR   | TAG        | true       | true         |
    | region      | VARCHAR   | TAG        | true       | true         |
    | time        | TIMESTAMP | TIMESTAMP  | true       | false        |
    | temperature | DOUBLE    | FIELD      | false      | false        |
    | humidity    | BIGINT    | FIELD      | false      | false        |
    +-------------+-----------+------------+------------+--------------+

Veri yazma

Not

İki veri noktası aynı etiket değerlerine ve zaman damgalarına sahipse, bunlar aynı veri noktası olarak kabul edilir. Sonraki yazma işlemi öncekinin üzerine yazar.

  • Verileri satır satır yazın.

    INSERT INTO sensor (device_id, region, time, temperature, humidity) VALUES('F07A1260','north-cn','2021-04-22 15:33:00',12.1,45);
    INSERT INTO sensor (device_id, region, time, temperature, humidity) VALUES('F07A1260','north-cn','2021-04-22 15:33:10',13.2,47);
    INSERT INTO sensor (device_id, region, time, temperature, humidity) VALUES('F07A1260','north-cn','2021-04-22 15:33:20',10.6,46);
    INSERT INTO sensor (device_id, region, time, temperature, humidity) VALUES('F07A1261','south-cn','2021-04-22 15:33:00',18.1,44);
    INSERT INTO sensor (device_id, region, time, temperature, humidity) VALUES('F07A1261','south-cn','2021-04-22 15:33:10',19.7,44);
  • Verileri toplu iş olarak yazın.

    INSERT INTO sensor (device_id, region, time, temperature, humidity) 
    VALUES ('F07A1260','north-cn','2021-04-22 15:33:00',12.1,45),
           ('F07A1260','north-cn','2021-04-22 15:33:10',13.2,47),
           ('F07A1260','north-cn','2021-04-22 15:33:20',10.6,46),
           ('F07A1261','south-cn','2021-04-22 15:33:00',18.1,44),
           ('F07A1261','south-cn','2021-04-22 15:33:10',19.7,44);

Veri sorgulama

Koşullu sorgu

F07A1260 cihazı için 2021-04-22 15:33:00 ile 2021-04-22 15:33:20 tarihleri arasındaki verileri sorgulayın:

SELECT device_id,region,time,temperature,humidity FROM sensor WHERE device_id = 'F07A1260' AND time >= '2021-04-22 15:33:00' AND time <= '2021-04-22 15:33:20';

Sorgu sonucu aşağıdaki gibidir:

+-----------+----------+---------------------------+-------------+----------+
| device_id |  region  |           time            | temperature | humidity |
+-----------+----------+---------------------------+-------------+----------+
| F07A1260  | north-cn | 2021-04-22T15:33:00+08:00 | 12.1        | 45       |
| F07A1260  | north-cn | 2021-04-22T15:33:10+08:00 | 13.2        | 47       |
| F07A1260  | north-cn | 2021-04-22T15:33:20+08:00 | 10.6        | 46       |
+-----------+----------+---------------------------+-------------+----------+

Alt örnekleme sorgusu

Alt örnekleme sorgusu, sonuç kümesindeki veri noktalarının sayısını azaltmak için zaman serisi verilerinin örneklemesini düşürür.

Aşağıdaki örnek, F07A1260 cihazı için 2021-04-22 15:33:00 ile 2021-04-22 15:33:20 tarihleri arasındaki sıcaklığı sorgular, verileri her 20 saniyede bir alt örnekleme yapar ve maksimum değeri döndürür:

SELECT device_id,region,time,max(temperature) AS max_temperature FROM sensor WHERE device_id = 'F07A1260' AND time >= '2021-04-22 15:33:00' AND time <= '2021-04-22 15:33:20' SAMPLE BY 20s;

Sorgu sonucu aşağıdaki gibidir:

+-----------+----------+---------------------------+-----------------+
| device_id |  region  |           time            | max_temperature |
+-----------+----------+---------------------------+-----------------+
| F07A1260  | north-cn | 2021-04-22T15:33:00+08:00 | 13.2            |
| F07A1260  | north-cn | 2021-04-22T15:33:20+08:00 | 10.6            |
+-----------+----------+---------------------------+-----------------+

Toplamalı sorgu

Tüm bölgelerdeki maksimum sıcaklığı hesaplayın:

SELECT region,max(temperature) AS max_temperature FROM sensor WHERE time >= '2021-04-22 15:33:00' AND time <= '2021-04-22 15:33:20' GROUP BY region;

Sorgu sonucu aşağıdaki gibidir:

+----------+-----------------+
|  region  | max_temperature |
+----------+-----------------+
| north-cn | 13.2            |
| south-cn | 19.7            |
+----------+-----------------+

Yaygın Lindorm-cli komutları

  • help: Yardımı görüntüleyin.

  • connect: Bir sunucuya bağlanın.

  • precision: Zaman görüntüleme biçimini ayarlayın. Desteklenen biçimler: rfc3339, h, m, s, ms, u veya ns.

  • exit veya quit: Lindorm zaman serisi motoruna olan mevcut bağlantıdan çıkın.

SSS

Başarılı veri eklemeden sonra neden sorgu sonucu boş?

Başarılı bir yazma işleminden sonra bir sorgu veri döndürmüyorsa, DESCRIBE DATABASE <veritabanı adı> komutunu çalıştırarak veritabanının bir yaşam süresi (TTL) ayarına sahip olup olmadığını kontrol edin. TTL'den daha eski veriler otomatik olarak silinir ve sorgulanamaz.

Lindorm-cli zaman serisi verilerini içe veya dışa aktarabilir mi?

  • Küçük veri hacimleri için Lindorm-cli'yi kullanarak CSV dosyalarını hızlı bir şekilde içe veya dışa aktarabilirsiniz. Gerekirse Lindorm teknik desteğiyle (DingTalk Kimliği: s0s3eg3) iletişime geçin.

  • Büyük veri hacimleri için DataX kullanarak verileri içe aktarın. Büyük ölçekli verilerin dışa aktarılması desteklenmez.