Skip to content

Add documentation for Azure Linux installation #561

Description

@jonmclean

Please add mssql-python installation instructions for Azure Linux [https://github.com/microsoft/AzureLinux] Azure Linux is Microsoft's minimal Linux distribution and is very handy for building Docker images that are deployed to Azure environments.

I tried to install required prerequisites in my Dockerfile using this code:

# krb5-libs and libtool-ltdl are mssql-python native deps (https://github.com/microsoft/mssql-python#installation)
RUN tdnf distro-sync -y && \
    tdnf install -y \
    ca-certificates \
    git \
    libtool \
    krb5-libs \
    libtool-ltdl \
    python3 \
    shadow-utils \
    sudo \
    util-linux && \
    tdnf clean all

After pip installing mssql_python in the Docker container and trying to run I get this error message:

  File "/opt/venv/lib/python3.12/site-packages/graphragzero/api/executors/retrieval.py", line 232, in _run
    if storage.has_dimensionality_reducer():
       ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/graphragzero/utils/time.py", line 21, in _wrapper
    result = func(*args, **kwargs)
             ^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/graphragzero/example_integrations/azure_sql_db_storage.py", line 982, in has_dimensionality_reducer
    with connect(self._context.connection_string) as conn, conn.cursor() as cursor:
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/mssql_python/db_connection.py", line 55, in connect
    conn = Connection(
           ^^^^^^^^^^^
  File "/opt/venv/lib/python3.12/site-packages/mssql_python/connection.py", line 332, in __init__
    self._conn = ddbc_bindings.Connection(
                 ^^^^^^^^^^^^^^^^^^^^^^^^^
RuntimeError: Failed to allocate environment handle

This looks like a pybind error to me so I assume there are more dependencies that need to be installed.

Activity

  1. github-actions commented on May 8, 2026

    @github-actions

    Hi Jon McLean (@jonmclean), thank you for opening this issue!

    Our team will review it shortly. We aim to triage all new issues within 24-48 hours and get back to you.

    If you have additional information to share, please feel free to update the issue.

    Thank you for your patience!

  2. saurabh500 commented on May 8, 2026

    @saurabh500
    Contributor

    Jon McLean (@jonmclean) can you try adding this dep to your Dockerfile

    dnf install -y glibc-iconv
    

    This should help unblock.

  3. jonmclean commented on May 11, 2026

    @jonmclean
    ContributorAuthor

    Installing glibc-iconv worked and I submitted a PR to update the documentation. #561

  4. bewithgaurav commented on May 13, 2026

    @bewithgaurav
    Collaborator

    thanks for your contributions Jon McLean (@jonmclean)!
    closing this off :)

  5. added
    documentationImprovements or additions to documentation
    triage doneIssues that are triaged by dev team and are in investigation.
    and removed
    triage neededFor new issues, not triaged yet.
    on May 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

area: packaging-platformWheels, version support, OS/arch coverage (Linux/macOS/Windows), install or import failures.documentationImprovements or additions to documentationtriage doneIssues that are triaged by dev team and are in investigation.

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions