LookML을 수정하면 Looker IDE는 단일 파일 내에서 해결되지 않은 구문 오류를 알려줍니다(Looker IDE 개요 문서 페이지 참조).
전체 모델 유효성 검사를 수행하려면 LookML 검사기를 사용하세요. 누락된 조인으로 인한 잘못된 필드 참조와 같은 일부 오류는 모델을 전체적으로 확인해야 하므로 LookML 검사기가 실행될 때만 표시됩니다. 프로덕션 환경에 게시하기 전에 LookML 변경사항의 유효성을 검사해야 합니다. 유효성 검사는 데이터베이스 권한 문제와 같은 모든 문제를 포착하지는 못하지만 대부분의 오류를 방지합니다.
LookML 검사기는 마지막 LookML 유효성 검사 후 업데이트된 LookML 파일 또는 업데이트의 영향을 받는 파일만 스캔합니다.
모델 수준 설정이 변경되면 모든 것이 다시 검사됩니다.
뷰가 변경되면 이를 사용하는 Explore만 다시 검사됩니다.
Explore가 변경되면 해당 Explore만 다시 검사됩니다.
검증 실행
LookML 검사기를 실행하려면 Looker IDE 오른쪽 상단의 LookML 유효성 검사 버튼을 선택하거나 IDE 상단에서 프로젝트 상태 아이콘을 선택하여 프로젝트 상태 패널을 연 다음 LookML 유효성 검사 아이콘을 클릭합니다.
LookML 검사기를 실행한 후 해결해야 하는 오류 및 기타 경고 목록이 표시될 수 있습니다. 화살표를 선택하여 오류 또는 경고 목록을 펼칠 수 있습니다.
다른 변경사항을 적용한 후 프로젝트 상태 패널의 검사기 버튼을 다시 사용할 수 있게 됩니다.
유효성 검사 메시지
LookML에서 유효성 검사를 실행한 후 Looker에서 유효성 검사 메시지를 표시합니다.
LookML 오류를 찾을 수 없음
검사기에서 발견된 문제가 없으면 Looker는 LookerML 오류를 찾을 수 없음 텍스트와 함께 녹색 체크표시를 표시합니다.
LookML 오류
LookML 오류는 쿼리가 실행되지 못하도록 하는 문제입니다. 괄호 안의 숫자는 발견된 오류 수입니다(다음 예시에서는 9개).
확장된 문제 목록 내에서 유효성 검사가 통과하지 못한 이유를 확인할 수 있습니다. 종종 이 오류를 클릭하면 해당 코드의 문제 행으로 직접 이동하는 경우가 있습니다. 행 옆에 빨간색 'X'가 표시됩니다. 마우스를 가져가면 경우에 따라 더 자세한 오류 정보가 제공됩니다.
채팅팀 도움말: 가장 많이 표시되는 유효성 검사 오류는 '알 수 없거나 액세스할 수 없는 필드'입니다. 오류: 알 수 없거나 액세스할 수 없는 필드 권장사항 페이지에서 원인과 해결 방법을 확인합니다.
LookML 경고
LookML 경고로 인해 쿼리가 실행되지 않을 수 있지만 여전히 사용자에게 기능이 손상되거나 의도치 않은 기능이 발생할 수 있습니다. 오류에서와 마찬가지로 괄호 안의 숫자는 발견된 경고의 수입니다(다음 예시에서는 경고 3개).
LookML 오류와 마찬가지로, 프로젝트 상태 패널에서 경고를 선택한 다음 빨간색 X 아이콘 위로 마우스를 가져가 자세한 정보를 볼 수 있습니다. 이 방법으로 경고를 확장하고 문제 코드로 이동할 수 있습니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-22(UTC)"],[],[],null,["# Validating your LookML\n\nWhen you edit your LookML, the Looker IDE will alert you to any unresolved syntax errors within a single file (see the [Looker IDE overview](/looker/docs/looker-ide#ad_hoc_error_checking) documentation page).\n\nTo perform a full model validation, use the LookML Validator. Some errors, such as an invalid field reference due to a missing join, require a holistic look at the model and therefore are only surfaced when the LookML Validator is run. Be sure to validate your LookML changes before publishing them to the production environment. Although validation won't catch *every* issue, such as database permission issues, it will prevent most errors.\n| **Note:** The LookML Validator shouldn't be confused with the [Content Validator](/looker/docs/content-validation), which instead checks to see if the changes you've made will break any saved Looks.\n\nThe LookML Validator scans only LookML files that have been updated since the last LookML validation, or files that are affected by updates:\n\n- If a model-level setting changes, everything is validated again.\n- If a view changes, only the Explores where it is used are validated again.\n- If an Explore changes, only that Explore is validated again.\n\n| **Tip:** If you notice that the LookML validation takes a long time to complete, the first thing to check is the [`include`](/looker/docs/reference/param-model-include) parameter in your model file. If you include all your view files (`include: \"*.view\"`), the LookML Validator will have to check them all, which can affect performance. If this is the case, update the model file's `include` parameter so that only the needed view files are included.\n\n### Running validation\n\nTo run the LookML Validator, select the **Validate LookML** button at the top right of the Looker IDE; or select the **Project Health** icon at the top of the IDE to open the **Project Health** panel, and then click the **Validate LookML** icon.\n\nAfter you run the LookML Validator, you may see a list of errors and other warnings that you should address. You can select any arrow to expand the lists of errors or warnings.\n\nThe validator button in the **Project Health** panel will become available again if you make and save another change.\n\n### Validation messages\n\nLooker displays validation messages after running validation on your LookML.\n| **Note:** LookML dashboards show informational messages, rather than warnings, in the sidebar when [permissive localization](/looker/docs/model-localization#localization_level) is enabled.\n\n\n#### No LookML errors found\n\nWhen there are no issues found by the validator, Looker displays a green checkmark along with the text **No LookML errors found**.\n\n#### LookML errors\n\nLookML errors are issues that could prevent queries from running. The number in parentheses is the number of errors found (nine in the following example):\n\nWithin the expanded list of issues you will see the reason validation didn't pass. Often times, if you click on the error, it will bring you directly to the problem row of code. You'll see a red \"X\" next to the row. Hovering over it will provide more detailed error information in some cases:\n\n\u003e **Chat Team Tip** : The validation error we are asked about most is \"Unknown or inaccessible field.\" Visit the [Error: Unknown or inaccessible field](/looker/docs/best-practices/error-unknown-or-inaccessible-field) Best Practices page for the causes and what to do about it.\n\n#### LookML warnings\n\nLookML warnings may not prevent a query from being run, but they may still result in broken or unintended functionality for your users. As with errors, the number in parentheses is the number of warnings found (three warnings in the following example):\n\nAs with LookML errors, you can expand warnings and jump to the problem code by selecting the warning in the **Project Health** panel and then hovering over the red **X** icon to view more information:\n\nDeploying your changes\n----------------------\n\nAfter you've validated that your changes will work properly, you can use Looker's Git integration to [commit and deploy your changes to production](/looker/docs/version-control-and-deploying-changes#getting_your_changes_to_production).\n| **Note:** If you change field names that serve as filters in your Looks or dashboards, be sure to review the **Filters** section of your scheduled Looks and dashboards and update the filters as needed to reflect your changes. If a scheduled content delivery includes filters that no longer function (for example, if the referenced field has changed), the scheduled delivery could expose unfiltered data."]]
