Loại dữ liệu và loại ngữ nghĩa

Khi bạn tạo một trình kết nối cộng đồng, mỗi trường mà bạn xác định trong giản đồ đều yêu cầu một loại dữ liệu. Kiểu dữ liệu xác định kiểu nguyên thuỷ của trường, chẳng hạn như BOOLEAN, STRING, NUMBER, v.v.

Ngoài các kiểu dữ liệu, Looker Studio cũng sử dụng các kiểu ngữ nghĩa. Loại ngữ nghĩa giúp mô tả loại thông tin mà dữ liệu biểu thị. Ví dụ: một trường có kiểu dữ liệu NUMBER có thể biểu thị một cách ngữ nghĩa số tiền hoặc tỷ lệ phần trăm của đơn vị tiền tệ và một trường có kiểu dữ liệu STRING có thể biểu thị một cách ngữ nghĩa một thành phố. Để biết những loại ngữ nghĩa có sẵn, vui lòng tham khảo tài liệu về các loại ngữ nghĩa

Lược đồ Trình kết nối cộng đồng và các trường Looker Studio

Khi xác định giản đồ cho trình kết nối cộng đồng, bạn sẽ có nhiều thuộc tính cho mỗi trường để xác định cách trường được biểu thị và sử dụng trong Looker Studio. Ví dụ:

  • conceptType được xác định trong giản đồ trình kết nối bằng thuộc tính conceptType. Thuộc tính này xác định xem trường có được coi là phương diện hay chỉ số hay không. Bạn có thể xem phần giải thích về sự khác biệt giữa chỉ số và phương diện tại Phương diện và chỉ số.
  • Bạn có thể xác định loại ngữ nghĩa trong giản đồ trình kết nối hoặc Looker Studio có thể tự động phát hiện dựa trên thuộc tính kiểu dữ liệu được xác định trong trình kết nối và các giá trị dữ liệu mà trình kết nối trả về. Hãy xem phần Tính năng tự động phát hiện loại ngữ nghĩa để biết thông tin chi tiết về cách hoạt động của tính năng này.
  • Loại tổng hợp xác định xem bạn có thể tổng hợp lại các giá trị chỉ số (hệ thống bỏ qua phương diện) hay không. Nếu bạn đặt thuộc tính semantics.isReaggregatable thành true, thì theo mặc định, thuộc tính này sẽ được đặt thành chế độ tổng hợp SUM, nếu không thì thuộc tính này sẽ được đặt thành Auto. Bạn cũng có thể đặt loại tổng hợp mặc định cho các trường có thể tổng hợp lại theo cách thủ công bằng cách sử dụng thuộc tính defaultAggregationType.

Khi bạn định cấu hình và kết nối bằng một trình kết nối trong Looker Studio, trình chỉnh sửa trường sẽ cho thấy lược đồ hoàn chỉnh cho trình kết nối dựa trên cách bạn đã xác định các thuộc tính ở trên. Nếu bạn đã thêm các loại ngữ nghĩa, thì chúng sẽ xuất hiện như bạn đã xác định. Nếu bạn đang sử dụng tính năng tự động phát hiện kiểu ngữ nghĩa, thì các trường sẽ xuất hiện như khi chúng được phát hiện. Màn hình Fields

Thiết lập thông tin ngữ nghĩa

Có hai cách để thiết lập thông tin ngữ nghĩa. Bạn có thể đặt ngữ nghĩa trường theo cách thủ công hoặc dựa vào Looker Studio để tự động phát hiện.

Ví dụ: Nếu bạn có một Số biểu thị theo ngữ nghĩa là Đô la Mỹ, thì Looker Studio sẽ không thể tự động phát hiện loại ngữ nghĩa này. Ngoài ra, tính năng phát hiện ngữ nghĩa tự động yêu cầu Looker Studio thực hiện các lệnh gọi tìm nạp dữ liệu cho từng trường trong giản đồ của bạn. Nếu bạn chỉ định giản đồ theo cách thủ công, thì sẽ không có lệnh gọi tìm nạp dữ liệu nào được thực hiện. Trong trường hợp bạn biết loại ngữ nghĩa (ví dụ: đơn vị tiền tệ, tỷ lệ phần trăm, ngày, v.v.) cho dữ liệu của mình, thì bạn nên đặt loại này một cách rõ ràng trong giản đồ vì lý do chính xác và hiệu suất.

Thiết lập các loại ngữ nghĩa theo cách thủ công (Nên dùng)

Nếu biết các loại ngữ nghĩa, bạn có thể xác định semantics theo cách thủ công cho từng trường lược đồ. Bạn có thể xem toàn bộ thông tin chi tiết về những thuộc tính mà bạn có thể sử dụng trong trang tham chiếu trường. Nếu chọn xác định các loại ngữ nghĩa theo cách thủ công, bạn nên xác định semanticType và semanticGroup cho mọi trường. Bằng cách cung cấp các thuộc tính này theo cách thủ công, quy trình tự động phát hiện loại ngữ nghĩa sẽ không chạy. Nếu bạn đặt một số trường theo cách thủ công nhưng không phải tất cả, thì những trường mà bạn không chỉ định sẽ mặc định là Text, Number hoặc Boolean, tuỳ thuộc vào dataType được chỉ định cho trường đó.

Sau đây là ví dụ về một giản đồ đơn giản đặt các loại ngữ nghĩa theo cách thủ công. Income được đặt làm Đơn vị tiền tệ và Filing Year được đặt làm ngày.

data-studio/semantics.gs
var schema = [
  {
    'name': 'Income',
    'label': 'Income (in USD)',
    'dataType': 'NUMBER',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'CURRENCY',
      'semanticType': 'CURRENCY_USD'
    }
  }, {
    'name': 'Filing Year',
    'label': 'Year in which you filed the taxes.',
    'dataType': 'STRING',
    'semantics': {
      'conceptType': 'METRIC',
      'semanticGroup': 'DATE_OR_TIME',
      'semanticType': 'YEAR'
    }
  }
];

Khắc phục sự cố về các loại ngữ nghĩa thủ công

Nếu bạn đặt sai loại ngữ nghĩa cho dữ liệu cơ bản, thì các loại này sẽ không hoạt động đúng cách. Bạn có thể gặp khó khăn khi kiểm thử, nhưng có một số việc bạn có thể làm để giúp tìm ra vấn đề.

  1. Trả về 2 hoặc 3 hàng dữ liệu thay vì tất cả, sau đó kiểm tra dữ liệu theo cách thủ công.
  2. Tạo một bảng trong Looker Studio chỉ sử dụng trường mà bạn đang cố gắng kiểm tra.
  3. Hãy chú ý kỹ đến các trường Geo và Date vì chúng có định dạng nghiêm ngặt nhất.

Tự động phát hiện loại ngữ nghĩa

Nếu bạn chưa xác định bất kỳ loại ngữ nghĩa nào trong giản đồ, thì Looker Studio sẽ cố gắng tự động phát hiện các loại đó dựa trên thuộc tính kiểu dữ liệu và định dạng của các giá trị dữ liệu do trình kết nối của bạn trả về.

Sau đây là các bước trong quy trình phát hiện tự động:

  1. Yêu cầu giản đồ bằng cách thực thi hàm getSchema của trình kết nối cộng đồng.
  2. Lặp lại các lô trường được xác định trong giản đồ trình kết nối và đưa ra các yêu cầu getData cho các trường. Các yêu cầu getData được thực thi với tham số sampleExtraction được đặt thành true để cho biết các yêu cầu dữ liệu là cho mục đích phát hiện ngữ nghĩa.
  3. Dựa trên kiểu dữ liệu của trường và định dạng của giá trị được trả về từ yêu cầu getData, hãy xác định kiểu ngữ nghĩa của trường.

Các lựa chọn để xử lý tính năng tự động phát hiện loại ngữ nghĩa

Khi Looker Studio thực thi hàm getData của một trình kết nối cộng đồng cho mục đích phát hiện ngữ nghĩa, yêu cầu đến sẽ chứa một thuộc tính sampleExtraction được đặt thành true. Dữ liệu do trình kết nối của bạn trả về chỉ được Looker Studio dùng để xác định loại ngữ nghĩa của trường. Vì giá trị này sẽ không được dùng cho bất kỳ mục đích nào khác, nên bạn không cần dữ liệu thực tế từ nguồn bên ngoài.

Có một số cách để cải thiện khả năng phát hiện loại ngữ nghĩa trong mã của bạn:

  • Nên dùng: Truyền các giá trị được xác định trước
    Trả về một giá trị được xác định trước cho mỗi trường thể hiện rõ nhất loại ngữ nghĩa của trường và được Looker Studio phát hiện đúng cách. Ví dụ: nếu kiểu ngữ nghĩa cho một trường là Quốc gia, thì hãy trả về một giá trị như IT cho Ý. Lợi ích khác của phương pháp này là nhanh hơn nhiều vì bạn không cần phải đưa ra yêu cầu HTTP cho dịch vụ bên thứ ba để lấy dữ liệu.

  • Chỉ trả về n số lượng bản ghi
    Nếu dịch vụ bên thứ ba mà bạn đang tìm nạp dữ liệu hỗ trợ giới hạn hàng khi yêu cầu dữ liệu, thì hãy trả về một tập hợp con nhỏ gồm các hàng cho Looker Studio thay vì toàn bộ tập dữ liệu. Điều này sẽ giới hạn lượng dữ liệu bạn cần truyền đến Looker Studio cho mỗi yêu cầu phát hiện ngữ nghĩa.

  • Yêu cầu tất cả các cột và lưu phản hồi vào bộ nhớ đệm
    Nếu có thể yêu cầu tất cả các cột cho dịch vụ bên thứ ba mà bạn đang tìm nạp dữ liệu, thì trong yêu cầu phát hiện ngữ nghĩa đầu tiên nhận được từ Looker Studio, hãy tìm nạp tất cả các cột và lưu kết quả vào bộ nhớ đệm. Đối với các yêu cầu phát hiện ngữ nghĩa tiếp theo, hãy tìm nạp các giá trị cột từ bộ nhớ đệm thay vì đưa ra các yêu cầu HTTP bổ sung cho dịch vụ bên thứ ba.

  • Không làm gì khác
    Bạn có thể chọn không triển khai bất kỳ biện pháp hỗ trợ cụ thể nào cho các yêu cầu mà sampleExtraction được đặt thành true. Điều này sẽ khiến quá trình Phát hiện ngữ nghĩa diễn ra chậm hơn vì Looker Studio sẽ phải tìm nạp tất cả dữ liệu cho quá trình Phát hiện ngữ nghĩa. Ngoài ra, điều này sẽ ảnh hưởng đến tốc độ yêu cầu đối với nguồn dữ liệu bên ngoài của bạn vì nhiều yêu cầu phát hiện ngữ nghĩa sẽ được thực thi song song.

Các định dạng được nhận dạng để tự động phát hiện loại ngữ nghĩa

Ngày và giờ
  • YYYY/MM/DD-HH:MM:SS
  • YYYY-MM-DD [HH:MM:SS[.uuuuuu]]
  • YYYY/MM/DD [HH:MM:SS[.uuuuuu]]
  • YYYYMMDD [HH:MM:SS[.uuuuuu]]
  • Sat, 24 May 2008 20:09:47 GMT
  • 2008-05-24T20:09:47Z
  • Thời gian: thời gian bắt đầu của hệ thống tính bằng giây, micro giây, mili giây và nano giây.
Địa lý